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《Kotlin for android developers》 中 文 版 翻 
译 


错别字 、 病 句 、 翻 译 错误 等 问题 可 以 提 issues。 请 说 明 错 误 原因 。 

1. 在 线 阅读 或 下 载 GitBook 

2. 在 线 阅 读 
希望 大 家 购买 正版 ， 建 议 阅读 英文 原版 : https://leanpub.com/kotlin-for-android- 
developers 


e Github: https://github.com/wangjiegulu/kotlin-for-android-developers-zh 


最 后 打 个 广告 哈 ， 阿 里 巴巴 ， 杭 州 招 技术 ， 支 持 电 话 视频 面试 ， 有 兴趣 的 同学 戳 这 
里 : https://github.com/wangjiegulu/jobs 


学 习 通 过 Kotlin 语 言 来 简单 地 开发 android 应 用 。 


关于 本 书 


在 这 本 书 中 ， 我 会 使 用 Kotlin 作 为 主要 的 语言 来 开发 一 个 android 应 用 。 方 式 是 通过 

开发 一 个 应 用 来 学 习 这 门 语言 ， 而 不 是 根据 传统 的 结构 来 学 习 。 我 会 在 感 兴 趣 的 点 

a 与 Java1.7 对 比 的 方式 讲 讲 Kotlin 的 一 些 概念 和 特性 。 用 这 种 方法 你 就 能 
道 它 们 的 不 同 之 处 ， 并 且 知 道 哪 部 分 语言 特性 可 以 让 你 提高 你 的 工作 效率 。 


这 本 书 并 不 是 一 本 语言 参考 书 ， 但 它 是 一 个 Android 开 发 者 去 学 习 Kotlin 并 且 使 用 在 
自己 项 目 。 我 会 通过 使 用 一 些 语言 特性 和 有 趣 的 工具 和 库 来 解决 很 多 
我 们 在 日 常生 活 当 中 都 会 遇 到 的 典型 问题 。 


这 本 书 是 非常 具有 实践 性 的 ， 所 以 我 建议 你 在 电脑 面前 跟着 我 的 例子 和 代码 实践 。 
无 论 何 时 你 都 可 以 在 有 一 些 想法 的 时 候 深 入 到 实践 中 去 。 


就 如 你 知道 的 ， 这 是 一 个 精益 出 版 。 也 就 是 说 这 本 书 是 跟 你 一 起 写 下 去 的 。 我 会 根 
据 你 的 回复 和 建议 来 写 新 的 内 容 和 检查 之 前 的 内 容 。 尽 管 这 本 书 已 经 完成 了 ， 但 是 

我 会 及 时 根据 新 的 Kotlin 版 本 更 新 。 所 以 尽管 编写 意见 告诉 我 你 对 这 本 书 的 看 法 ， 

或 者 需要 改进 的 地 方 。 我 希望 这 本 书 会 成 为 Android 开 发 者 的 一 个 完美 的 工具 ， 正 
因为 如 此 ， 欢 迎 大 家 的 想法 和 帮助 。 


感谢 你 将 成 为 这 个 激动 人 心 的 项 目的 一 部 分 。 


这 本 书 适合 你 吗 ? 
写 这 本 书 是 为 了 帮助 那些 有 兴趣 使 用 Kotlin 语 言 来 进行 开发 的 Android 开 发 者 。 
如 果 你 符合 下 面 这 些 情况 ， 那 这 本 书 是 适合 你 的 : 


你 有 相关 Android 开 发 和 Android SDK 的 基本 知识 。 

e 你 希望 跟随 一 个 使 用 Kotlin 语 言 编 写 的 例子 来 学 习 Kotlin。 

e 你 需要 一 个 怎么 去 使 用 更 简洁 生动 的 语言 来 解决 日 常生 活 遇 到 的 典型 问题 的 指 
南 o 


另 一 方面 ， 这 本 书 可 能 不 太 适 合 你 ， 因 为 : 


e 这 本 书 不 是 Kotlin 圣 经 。 我 会 去 解释 所 有 Kotlin 的 基本 语法 ， 甚 至 包括 在 过 程 中 
遇 到 我 需要 的 一 些 相 对 比较 复杂 的 想法 。 所 以 你 是 通过 一 个 例子 去 学 习 ， 而 不 
是 其 他 方式 。 

e 我 不 会 去 解释 怎么 样 去 开发 一 个 Android 应 用 。 你 不 需要 很 深 的 开发 知识 ， 但 
是 至 少 了 解 基础 ， 比 如 Android Studio，Gradle，Java 语 言 和 Android SDK。 
你 可 能 会 从 中 学 到 一 些 关于 Android 开 发 的 一 些 新 的 东西 。 

e 这 本 书 不 是 函数 式 编程 语言 指南 。 当 然 由 于 Java 7 完全 不 是 函数 式 风 格 的 ， 我 
会 解释 你 需要 知道 的 东西 ， 但 是 不 会 很 深入 地 去 讲解 函数 式 编程 的 话题 。 


关于 作者 


Antonio Leiva 是 一 个 Android 工 程 师 ， 他 专注 于 研究 新 的 潜在 的 Android 开 发 可 能 
性 ， 然 后 写作 说 明 。 他 维护 一 个 关于 很 多 不 同 Android 开 发 话题 的 博客 
antonioleiva.com ° 

Antonio 一 开始 是 CRM 技 术 顾 问 ， 但 是 一 段 时 间 之 后 ， 他 寻找 着 新 的 激情 ， 他 发 现 
了 Android 世 界 。 在 优秀 的 平台 上 获得 了 相关 经 验 ， 之 后 他 加 入 了 一 个 西班牙 重要 
的 手机 公司 带领 多 个 项 目 作 为 新 的 冒险 。 


现在 ， 他 在 Plex 担 任 Android 工 程 师 ， 并 且 在 Android 的 设计 和 UX 方 面 也 担任 重要 的 
角色 。 


你 可 以 在 Twitter 上 关注 他 @lime cl。 


如 果 你 觉得 Java 7 是 一 个 过 期 的 语言 ， 并 决定 找 一 个 更 现代 的 语言 代替 。 茶 喜 你 ! 
就 如 你 知道 的 ， 虽 然 Java 8 已 经 发 布 了 ， 它 包含 了 很 多 我 们 期 待 的 像 现 代 语 言 中 那 
样 的 改善 ， 但 是 我 们 Android 开 发 者 还 是 被 迫 在 使 用 Java 7. 这 是 因为 法 律 的 问题 。 
但 是 就 算 没 有 这 个 限制 ， 并 且 新 的 Android 设 备 从 今天 开始 使 用 新 的 能 理解 Java8 的 
VM， 在 当前 的 设备 过 期 、 几 乎 没有 人 使 用 它们 之 前 我 们 也 不 能 使 用 Java 8， 所 以 
恐怕 我 们 不 会 很 快 等 到 这 一 天 的 到 来 。 


但 是 并 不 是 没有 补救 的 方法 o 多 亏 使 用 了 JVM ; 我 们 可 以 使 用 任何 语言 去 编写 
Android 应 用 ， 只 要 它 能 够 编译 成 JVM 能 够 认识 的 字 节 码 就 可 以 了 。 

正如 你 所 想 ’ 有 很 多 选择 ， 比如 Groovy » Scala ， Clojure ， 当 然 还 有 Kotlin 。 通过 实 
践 ， 只 有 其 中 一 些 能 够 被 考虑 来 作为 替代 品 。 

上 述 的 每 一 种 语言 都 有 它 的 利 丈 ， 如 果 你 还 没有 站 正确 定 你 该 使 用 那 种 语言 ， 我 建 
议 你 可 以 去 尝试 一 下 它们 。 


什么 是 Kotlin? 


Kotlin， 如 前 面 所 说 ， 它 是 JetBrains 开 发 的 基于 JVM 的 语言 。JetBrains 因 为 创造 了 
一 个 强大 的 Java 开 发 [DE 被 大 家 所 熟知 。Android Studio， 官 方 的 Android IDE， 就 
是 基于 Intellij， 作 为 一 个 该 平台 的 插件 。 


Kotlin 是 使 用 Java 开 发 者 的 思维 被 创建 的 ，lIntellj 作 为 它 主要 的 开发 IDE。 对 于 
Android 开 发 者 ， 有 两 个 有 趣 的 特点 : 


但 


对 Java 开 发 者 来 说 ，Kotlin 是 非常 直觉 化 的 ， 并 且 非 常 容易 学 习 。 语 言 ba 
分 内 容 都 是 与 我 们 知道 Ar 不 同 的 地 方 ， 它 的 基础 概念 也 能 迅速 地 党 
WEE © 

它 与 我 们 日 常生 活 使 用 的 IDE 无 需 配置 就 能 完全 整合 。Android Studio 能 够 非常 
完美 地 理解 、 编 译 运 行 Kotlin 代 码 。 而 且 对 这 门 语 言 的 支持 正 是 来 自 于 开发 了 
这 个 IDE 的 公司 本 身 ， 所 以 我 们 Android 开 发 者 是 一 等 公民 。 


是 这 仅仅 是 开发 语言 和 开发 工具 之 间 的 整合 。 相 比 Java 7 的 优势 到 底 是 什么 呢 ? 


它 更 加 易 表 现 : 这 是 它 最 重要 的 优点 之 一 。 你 可 以 编写 少 得 多 的 代码 o 

它 更 加 安全 : Kotlin 是 空 安 全 的 ， 也 就 是 说 在 我 们 编译 时 期 就 处 理 了 Smal 

情况 ， 避 免 了 执行 时 异常 。 如 果 一 个 对 象 可 以 是 null， 则 我 们 需要 明确 地 指定 

它 ， 然 后 在 使 用 它 之 前 检查 它 是 否 是 null。 你 可 以 节约 很 多 调试 空 指针 异常 的 

时 间 ， 解 决 掉 null 引 发 的 bug。 

它 是 函数 式 的 : Kotlin 是 基于 面向 对 象 的 语言 。 但 是 就 如 其 他 很 多 现代 的 语言 

那样 ， 它 使 用 了 很 多 函数 式 编程 的 概念 ， 比 如 ， 使 用 lambda 表 达 式 来 更 方便 地 

解决 问题 。 其 中 一 个 很 棒 的 特性 就 是 Collections 的 处 理 方式 。 

它 可 以 扩展 函数 : 这 意味 着 我 们 可 以 扩展 类 的 更 多 的 特性 ， 其 至 我 们 没有 权限 

去 访问 这 个 类 中 的 代码 。 

它 是 高 度 互 操作 性 的 : 你 可 以 继续 使 用 所 有 的 你 用 Java 写 的 代码 和 库 ， 因 为 两 
个 语 言 之 间 的 互 操作 性 是 完美 的 。 共 至 可 以 在 一 个 项 目 中 使 用 Kotlin 和 Java 两 


ives 混合 编程 。 


我 们 通过 Kotlin 得 到 什么 


不 深入 Kotlin 语 言 (我 们 会 在 下 一 章 再 去 学 习 ) ， 这 里 有 一 些 Java 中 没有 的 有 趣 的 
特性 : 


日 

多 表现 
通过 Kotlin， 可 以 更 容易 地 避免 模版 代码 因为 大 部 分 的 典型 情况 都 在 语言 中 默认 堆 
盖 实 现 了 。 举 个 例子 ， 在 Java 中 ， 如 果 我 们 要 典型 的 数据 类 ， 我 们 需要 去 编写 (至 
`A > 


成 ) 这 些 代码 : 


— 
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public class Artist { 
private long id; 
private String name; 
private String url; 
private String mbid; 


public long getId() { 
return id; 


public void setId(long id) { 
this.id = id; 


public String getName() { 
return name; 


public void setName(String name) { 
this.name = name; 


public String getUrl() { 
return url; 


public void setUrl(String url) { 
this.url = url; 


public String getMbid() { 
return mbid; 


public void setMbid(String mbid) { 
this.mbid = mbid; 


@Override public String toString() { 
return "“Artist{™ + 
"id=" + id + 


", name='" + name + '\'' + 
u urla!" + url + LEN UR + 
", mbid='" + mbid + '\'' + 
Pyu g 


使 用 Kotlin， 我 们 只 需要 通过 数据 类 : 


data class Artist( 
var id: Long, 
var name: String, 
Var url: Strang, 
var mbid: String) 


这 个 数据 类 ， 它 会 自动 生成 所 有 属性 和 它们 的 访问 器 ， 以 及 一 些 有 用 的 方法 ， 比 
如 ， toString() 


当 我 们 使 用 Java 开 发 的 时 候 ， 我 们 的 代码 大 多 是 防御 性 的 。 如 果 我 们 


到 NullPointerException ， 我 们 就 需要 在 使 用 ee 它 是 否 为 
null。Kotlin， 如 很 多 现代 的 语言 ， 是 空 安全 的 ， 因 为 我 们 需要 通过 一 个 安全 调用 操 


Heke ( 写 做 ? ) 来 明确 地 指定 一 个 对 象 是 否 能 为 空 。 


我 们 可 以 像 这 样 去 写 


// 这 里 不 能 通过 编译 . Artist 不 能 是 null 
var notNullArtist: Artist = null 


I TN Ae mua 
var artist: Artist? = null 


// 无 法 编译 ，artist 可 能 是 nuL1， 我 们 需要 进行 处 理 
artist.print() 


// 只 要 在 artist != null 时 才 会 打印 
artist?.print() 


// 智能 转换 果 我 们 在 之 前 进行 了 空 检 查 ， 则 不 需要 使 用 安全 调用 操作 符 调用 


中 ees != null) { 
artist.print() 


/ 只 有 在 确保 artist 不 是 nulL1 的 情况 下 才能 这 么 调用 ， 否 则 它 会 抛 出 异常 
artist!!.print() 


// 使 用 Elvis 操 作 符 来 给 定 一 个 在 是 null1 的 情况 下 的 蔡 代 值 
val name = artist?.name ?: "empty" 


扩展 方法 


我 们 可 以 给 任何 类 添加 函数 。 它 比 那些 我 们 项 目 中 典型 eee 


BNF > MATT A A4Afragment?¥ Ao — + È TFtoastsy $ 


fun Fragment.toast(message: CharSequence, duration: Int = Toast. 
LENGTH_SHORT) { 
Toast .makeText(getActivity(), message, duration) .show() 


我 们 现在 可 以 这 么 做 : 


fragment.toast("Hello world!") 


函数 式 支 持 (Lambdas ) 


每 次 我 们 去 声明 一 个 点 击 所 触发 的 事件 ， 可 以 只 需要 定义 我 们 需要 做 些 什 么 ， 而 不 
是 不 得 不 去 实现 一 个 内 部 类 ? 我们 确实 可 以 这 么 做 ， 这 个 (或 者 其 它 更 多 我 们 感 兴 
趣 的 事件 ) 我 们 需要 感谢 lambda : 


view.setOnClickListener { toast("Hello world!") } 


这 里 只 是 挑选 了 很 小 一 部 分 Kotlin 可 以 简化 我 们 代码 的 事情 。 现 在 你 已 经 知道 这 门 
语言 的 一 些 有 趣 的 特性 了 ， 你 可 以 考虑 它 是 否 是 适合 你 的 。 如 果 你 选择 继续 ， 我 们 
将 在 下 一 章 开始 我 们 的 实践 之 旅 。 


准备 工作 


现在 你 知道 使 用 Kotlin 实 现 的 小 例子 了 ， 我 确信 你 会 希望 尽 可 能 快 地 把 它 用 在 你 的 
实践 当中 去 。 不 要 担心 ， 在 第 一 章 中 会 帮助 你 去 搭建 你 的 开发 环境 ， 这 样 你 才能 立 
即 编写 代码 。 


Android Studio 


第 一 件 事 就 是 安装 Android Studio。 就 如 你 知道 的 ，Android Studio 是 官方 的 
Android IDE， 它 是 2013 年 发 布 的 预览 版 ， 并 在 2014 年 发 布 了 正式 版 。 


Android Studio 是 Intellij IDEA% 4&4 & HL > Intellij IDEA & JetBrains#+ £ > Kotlin 
就 是 JetBrains 创 造 的 。 所 以 ， 正 如 你 所 见 ， 一 切 都 这 么 紧密 地 结合 起 来 了 。 


转移 到 Android Studio 是 Android 开 发 者 一 个 重要 的 改变 。 首 先 ， 因 为 我 们 放弃 了 
Eclipse 并 转 到 专 为 Java 开 发 者 设计 的 完美 的 语言 交互 的 软件 。 我 们 可 以 享受 到 完美 
的 特性 体验 ， 比 如 反应 快速 和 令 人 影响 深刻 的 智能 代码 提示 ， 还 有 强大 的 分 析 和 重 
构 工 具 。 


第 二 ，Gradle 成 为 Android 官 方 的 系统 构建 工具 ， 这 意味 着 版 本 构建 和 部 署 的 新 的 
可 能 性 。 最 有 趣 的 两 点 是 系统 构建 和 flavours， 它 可 以 让 你 使 用 相同 的 代码 库 来 创 
建 无 限 的 版 本 (甚至 是 不 同 的 应 用 ) 。 


如 果 你 仍然 在 使 用 Eclipse， 为 了 跟 上 这 本 书 ， 丽 怕 你 需要 转移 到 Android Studio 
了 。Kotlin 团 队 也 创建 了 一 个 针对 Eclipse 的 插件 ， 但 是 它 是 远 远 落后 于 Android 
Studio 的 ， 而 且 结 合 得 也 并 不 完美 。 你 一 旦 使 用 了 它 ， 你 就 会 觉得 相 见 恨 晚 。 


我 不 会 去 覆盖 到 Android eae ， 因 为 这 些 都 不 是 本 书 的 重点 ， 但 
是 如 果 你 以 前 没有 使 用 过 这 些 工 具 ， 不 要 恐慌 ， 我 确信 你 能 够 跟随 本 书 的 同时 学 习 
到 相关 基础 。 


如 果 你 还 没有 AndroidStudio， 点 这 里 从 官网 下 载 。 


安装 Kotlin 插 件 





因为 从 Intellj 15 开 始 ， 插 件 是 被 默认 安装 了 的 ， 但 是 你 的 Android Studio 可 能 并 没 
有 。 所 以 你 需要 进入 Android Studio 的 Preferences 的 plugin 栏 ， 然 后 安装 Kotlin 插 
件 。 如 果 你 不 会 就 去 搜索 下 。 


现在 我 们 的 环境 已 经 可 以 理解 Kotlin 语 言 了 ， 可 以 就 像 我 们 使 用 Java 一 样 无 缝 地 编 
译 它 ， 执 行 它 。 


创建 一 个 新 的 项 目 


如 果 你 已 经 使 用 过 Android Studio 和 Gradle， 那 么 会 比较 简单 。 我 不 会 给 出 
很 多 细节 和 截图 ， 因 为 用 户 界 面 和 细节 ae ° 


我 们 的 应 用 是 由 一 个 简单 的 天 气 app 组 成 ， 正 如 所 使 用 的 Google's Beginners 
Course in Udacity。 我 们 可 能 会 关注 不 同 的 事情 ， 但 是 app 的 想法 都 是 一 样 的 ， 你 
会 发 现在 一 个 典型 的 app 里 面 会 包括 很 多 不 同 的 东西 。 如 果 你 的 Android 开 发 水 平 比 
较 低 ， 我 推荐 这 个 ， 这 个 过 程 是 比较 容易 的 。 


在 Android Studio 中 创建 一 个 项 目 


首先 ， 打 开 Android Studio 并 选择 Create new Project ， 然 后 它 会 让 你 输入 一 个 
名 字 ， 你 可 以 任意 取 一 个 名 字 ， 比 如 : Weather App 。 然 后 你 需要 输入 公司 域 
名 。 如 果 你 不 会 真正 发 布 这 个 app， 这 个 字段 就 不 是 特别 重要 了 ， 但 是 如 果 你 有 的 
话 可 以 使 用 自己 的 域名 。 然 后 任意 选择 一 个 目录 作为 这 个 项 目的 保存 地 址 。 


下 一 步 ， 它 会 让 你 选择 最 小 的 API 版 本 。 我 们 选择 API 15， 因 为 我 们 有 一 
至 少 API 15 才 能 用 。 无 论 如 何 你 把 大 部 分 的 Anroid 用 户 作 为 了 目标 。 现 在 不 要 选 
任何 除了 手机 和 平板 的 其 它 平 台 。 


最 后 ， 我 们 需要 选择 一 个 Activity 模 版 来 作为 入 口 。 我 们 可 以 选择 Add no 
Activity 然后 从 头 开 始 (这 是 一 个 好 的 方式 如 果 这 是 一 个 Kotlin 项 目的 话 ) ， 但 是 
我 将 选择 Blank Activity ， 因 为 我 待 会 儿 会 给 你 展示 Kotlin 插 件 一 个 好 玩 的 小 特 
性 O 


暂时 不 用 去 关心 Activity 的 名 字 ，layout 等 。 这 些 你 会 在 篇 中 知道 。 如 果 我 们 需 
要 ， 我 待 会 儿 会 修改 它 。 点 击 Finish 然后 让 它 继 ree o 


配置 Gradle 


Kotlin 插 件 包 括 一 个 让 我 们 配置 Gradle 的 工具 。 但 是 我 还 是 倾向 于 保持 我 对 Gradle 
文件 读 写 的 控制 权 ， 和 否则 它 只 会 变 得 混乱 而 不 会 变 得 简单 。 不 管 怎么 样 ， 在 使 用 自 
动工 具 之 前 知道 它 是 怎么 工作 的 是 个 不 错 的 主意 。 所 以 这 次 ， 我 们 将 手动 去 做 。 


首先 ， 你 需要 如 下 修改 父 build.gradle 


buildscript { 


ext.support_version = '23.1.1' 
ext. kotlin_version = '1.0.0' 
ext.anko_version = '0.8.2' 


repositories { 
jcenter() 
dependencies { 
classpath 'com.android.tools.build:gradle:1.5.0' 
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin 
:$kotlin_version" 


} 


} 
allprojects { 
repositories { 
jcenter() 


正如 你 看 到 的 ， 我 们 创建 了 一 个 变量 来 存储 当前 的 Kotlin 版 本 。 你 读 到 这 里 的 时 候 
去 检测 一 下 最 新 版 本 ， 因 为 可 能 会 有 更 新 的 版 本 已 经 发 布 了 。 我 们 需要 在 几 个 不 同 
的 地 方 用 到 那个 版 本 号 ， 比 如 你 需要 加 上 新 的 Kotlin 插 件 的 dependency 。 你 会 在 
你 指定 的 那些 模块 中 的 build.gradle 中 再 次 需要 到 Kotlin 标 准 库 。 


我 们 对 于 support library 也 是 如 此 ， Anko 库 也 是 同样 的 做 法 。 用 这 个 方式 可 
以 更 方便 地 在 一 个 地 方 修改 所 有 的 版 本 号 。 并 且 使 用 相同 的 版 本 号 ， 更 新 的 时 候 也 
不 需要 每 个 地 方 都 修改 。 


我 们 会 增加 Kotlin 标准 库 ， Anko 库 ， 以 及 Kotlin 和 Kotlin Android 
Extensions plugin 插件 到 dependencies。 


apply plugin: 'com.android.application' 
apply plugin: 'kotlin-android' 

apply plugin: 'kotlin-android-extensions' 
android { 


dependencies { 
compile "com.android.support:appcompat-v7:$support_version" 
compile "org. jetbrains.kotlin: kotlin-stdlib:$kotlin_version" 
compile "org. jetbrains.anko:anko-common:$anko_version" 


buildscript { 
repositories { 
jcenter() 
} 
dependencies { 
classpath "org.jetbrains.kotlin:kotlin-android-extensions: 
$kotlin_version" 


} 
} 
Anko 是 一 个 用 来 简化 一 些 Android 任 务 的 很 强大 的 Kotlin 库 。 我 们 之 后 将 会 学 习 部 分 
anko， 但 是 现在 来 说 仅仅 增加 anko-common 就 足够 了 。 这 个 库 被 分 割 成 了 一 系列 


小 的 部 分 以 至 于 我 们 不 会 把 没 用 到 的 部 分 加 进来 。 


把 MainActivity 转 换 成 Kotlin 代码 


Kotlin plugin 包 含 了 一 个 有 趣 的 特性 ， 它 能 把 Java 代 码 转 成 Kotlin 代 码 。 正 如 任何 自 
动 化 那样 ， 结 果 不 会 很 完美 ， 但 是 在 你 第 一 天 能 够 使 用 Kotlin 语 言 开 始 编写 代码 之 
前 ， 它 还 是 提供 了 很 多 的 帮助 。 


所 以 我 们 在 MainActivity.java 类 中 使 用 它 。 打 开 文 件 ， 然 后 选择 Code -> Convert 
Java File to Kotlin File 。 对 比 它们 的 不 同 之 处 ， 可 以 让 你 更 熟悉 这 门 语言 。 


测试 是 否 一 切 就 绪 


我 们 想 再 将 编写 一 些 代 码 来 测试 Kotlin Android Extensions 是 否 在 工作 。 我 现在 还 不 
会 对 这 些 代 码 做 解释 ， 但 是 我 想 要 确保 它们 在 你 的 环境 中 是 正常 运行 的 。 这 可 能 是 
配置 中 最 难 的 一 部 分 。 


首先 ， 打 开 activity_main.xml ， 然 后 设置 TextView 的 id : 


<TextView 
android:id="@+id/message" 
android: text="@string/hello_world" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content"/> 


然后 ， 手 动 在 Activity 中 增加 一 个 import 语 句 (不 要 担心 你 现在 对 这 个 还 不 太 理 
解 ) 。 


import kotlinx.android.synthetic.main.activity_main.* 


在 onCreate 中 ， 你 现在 可 以 直接 得 到 并 访问 这 个 TextView 了 。 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setContentView(R.layout.activity_main) 
message.text = "Hello Kotlin!" 


多 亏 Kotlin 和 Java 之 问 的 互 操作 性 ， 我 们 可 以 在 Kotlin 中 像 操作 属性 一 样 去 操作 Javal 
库 中 的 getter/setter 方 法 。 我 们 之 后 再 去 讲解 属性 ， 但 是 我 想 提 醒 的 是 ， 我 们 可 以 使 
用 message.text 来 代替 message.setText 。 编 译 器 将 会 把 它 转换 成 一 般 的 
Java 代 码 ， 所 以 这 样 使 用 是 没有 任何 性 能 开销 的 。 


现在 运行 这 个 app， 并 且 它 是 正常 运行 的 。 检 查 TextView 是 否 是 显示 的 新 的 内 容 。 
如 果 你 有 疑问 或 者 想 查看 代码 ， 请 在 Kotlin for Android Developers repository Æ 
看 。 每 个 章节 只 要 修改 了 代码 ， 我 都 会 进行 提交 ， 所 以 一 定 要 检查 所 有 的 代码 变 


化 。 


下 一 章 会 覆盖 你 在 转换 之 后 的 MainActivity 所 看 到 的 新 的 东西 。 一 旦 你 理解 了 Java 
和 Kotlin 之 间 的 细微 的 变化 ， 你 将 能 更 容易 独立 写 新 的 代码 了 。 


类 和 函数 


Kotlin 中 的 类 遵循 一 个 简单 的 结构 。 尽 管 与 Java 有 一 点 细微 的 差别 。 你 可 以 使 
用 try.kotlinlang.org 在 不 需要 一 个 丨 正 的 项 目 和 不 需要 部 署 到 机 器 的 前 提 下 来 测试 一 
些 简单 的 代码 范例 。 
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如 果 你 想 定 义 一 个 类 ， 你 只 需要 使 用 class 关键 字 。 


class MainActivity{ 


它 有 一 个 默认 唯一 的 构造 器 。 我 们 会 在 以 后 的 课程 中 学 习 在 特殊 的 情况 下 创建 其 它 
额外 的 构造 器 ， 但 是 请 记 住 大 部 分 情况 下 你 只 需要 这 个 默认 的 构造 器 。 你 只 需要 在 
类 名 后 面 写 上 它 的 参数 。 如 果 这 个 类 没有 任何 内 容 可 以 省 略 大 括号 : 


class Person(name: String, surname: String) 


那么 构造 函数 的 函数 体 在 哪 呢 ? 你 可 以 写 在 init RP: 


class Person(name: String, surname: String) { 
init{ 


类 继承 


默认 任何 类 都 是 基础 继承 自 any (与 java 中 的 object RM) ， 但 是 我 们 可 以 继 
承 其 它 类 。 所 有 的 类 默认 都 是 不 可 继承 的 (final) ， 所 以 我 们 只 能 继承 那些 明确 声 
明 open 或 者 abstract 的 类 : 


open class Animal(name: String) 
class Person(name: String, surname: String) : Animal(name) 


当 我 们 只 有 单个 构造 器 时 ， 我 们 需要 在 从 父 类 继承 下 来 的 构造 器 中 指定 需要 的 
数 。 这 是 用 来 替换 Java 中 的 super 调用 的 。 


hy 


函数 (我们 Java 中 的 方法 ) 可 以 使 用 fun 关键 字 就 可 以 定义 : 


E 


fun onCreate(savedInstanceState: Bundle?) { 


} 


如 果 你 没有 指定 它 的 返回 值 ， 它 就 会 返回 Unit ， 与 Java 中 的 void KM? 12 
是 Unit 是 一 个 申 正 的 对 象 。 你 当然 也 可 以 指定 任何 其 它 的 返回 类 型 : 


funeadd( x: Int, va Ink) nt 
return x + y 


小 提示 : 分 号 不 是 必须 的 

就 像 你 在 上 面 的 例子 中 看 到 的 那样 ， 我 在 每 句 的 最 后 没有 使 
你 也 可 以 使 用 分 号 ， 分 号 不 是 必须 的 ， 而 且 不 使 用 分 号 是 一 
践 。 当 你 这 么 做 了 ， 你 会 发 现 这 节约 了 你 很 多 时 间 。 


> # 
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然而 如 果 返 回 的 结果 可 以 使 用 一 个 表达 式 计 算出 来 ， 你 可 以 不 使 用 括号 而 是 使 用 等 


fun addi <2 Int, Vv; Ing): int =x + y 


NO 


构造 方法 和 函数 和 参数 


Kotlin 中 的 参数 与 Java 中 有 些 不 同 。 如 你 所 见 ， 我 们 先 写 参数 的 名 字 再 写 它 的 类 


型 : 


fun, adage Ine nt ne 
return X + y 


我 们 可 以 给 参数 指 Ph timeslots 变 得 可 选 ， 有 帮助 的 。 这 里 有 一 
个 例子 ， 在 Activity 中 创建 了 ane 


fun toast(message: String, length: Int = Toast.LENGTH_SHORT) { 
Toast.makeText(this, message, length) .show() 


如 你 所 见 ， 第 二 个 参数 (length) 指定 了 一 个 默认 值 。 这 意味 着 你 调用 的 时 候 可 以 
传 入 第 二 个 值 或 者 不 传 B e 


toast("Hello") 
toast("Hello", Toast.LENGTH_LONG) 


这 个 与 下 面 的 Java 代 码 是 一 样 的 : 


void toast(String message){ 


} 


void toast(String message, int length){ 
Toast.makeText(this, message, length) .show(); 


这 跟 你 想象 的 一 样 复杂 。 再 看 看 这 个 例子 


I > 由 > -t foa 2 EL A HL 
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fun niceToast(message: String, 
tag: String = javaClass<MainActivity>().getSimpl 
eName(), 
length: Int = Toast.LENGTH_SHORT) { 
Toast.makeText(this, "[$className] $message", length) .show() 


我 增加 了 第 三 个 默认 值 是 类 名 的 tag 参 数 。 如 果 在 Java 中 总 数 开 销 会 以 几何 增长 。 
现在 可 以 通过 以 下 方式 调用 : 


toast("Hello") 
toast("Hello", "MyTag") 
toast("Hello", "MyTag", Toast.LENGTH_SHORT) 


而 且 甚 至 还 有 其 它 选择 ， 因 为 你 可 以 使 用 参数 名 字 来 调用 ， 这 表示 你 可 以 通过 在 值 
前 写 明 参数 名 来 传 入 你 希望 的 参数 : 


toast(message = "Hello", length = Toast.LENGTH_SHORT ) 


小 提示 : String 模 版 
你 可 以 在 String 中 直接 使 用 模版 表达 式 。 它 可 以 帮助 你 很 简单 地 在 静态 值 和 
变量 的 基础 上 编写 复杂 的 String。 在 上 面 的 例子 中 ， 我 使 用 了 " 
[$className] $message" ° 
如 你 所 见 ， 任 何 时 候 你 使 用 一 个 $ 符号 就 可 以 插入 一 个 表达 式 。 如 果 这 个 


表达 式 有 一 点 复杂 ， 你 就 需要 使 用 一 对 大 括号 括 起 来 : "Your name is 
${user.name}" ° 
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编写 你 的 第 一 个 类 


我 们 已 经 有 了 MainActivity.kt 类 。 这 个 Activity 会 展示 下 周一 系列 的 天 气 预报 ， 
所 有 它 的 layout 需 要 有 些 改 变 。 


创建 一 个 layout 


显示 天 气 预 报 的 列表 我 们 使 用 RecyclerView ， 所 以 你 需要 在 build.gradle 中 
增加 一 个 新 的 依赖 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile "com.android.support:appcompat -v7:$support_version" 
compile "com.android.support:recyclerview-v7:$support_versio 
n" 


} 


然后 ， activity_main.xml 如 下 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/a 
ndroid" 
android: layout_width="match_parent" 
android: layout_height="match_parent"> 
<android.support.v7.widget .RecyclerView 
android: id="@+id/forecast_list" 
android: layout_width="match_parent" 
android: layout_height="match_parent"/> 
</FrameLayout> 


在 Mainactivity.kt 中 删除 掉 之 前 用 来 测试 的 能 正常 运行 的 所 有 代码 (现在 应 该 
会 提示 错误 ) 。 暂 且 我 们 使 用 老 的 findViewByid() 的 方式 : 


val forecastList = findViewById(R.id.forecast_list) as RecyclerV 
iew 
forecastList.layoutManager = LinearLayoutManager (this) 


如 你 所 见 ， 我 们 定义 类 一 个 变量 并 转型 为 RecyclerView ° Eee 点 不 
: > pre N 。 LayoutManager 会 通过 属性 的 方式 被 设 
， 而 不 是 通过 setter， 这 个 layout 已 经 足够 显示 一 个 列表 了 。 


创建 一 个 layout 


对 象 实例 化 


对 象 实 例 化 也 是 与 Java 中 有 些 不 同 。 如 你 所 见 ， 我 们 去 掉 了 new 关键 
字 。 这 时 构造 函数 仍然 会 被 调用 ， 但 是 我 们 省 略 了 宝贵 的 四 个 字 
符 。 LinearLayoutManager(this) 创建 了 一 个 对 象 的 实例 。 
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The Recycler Adapter 


我 们 同样 需要 一 个 RecyclerView 的 Adapter。 之 前 我 在 我 博客 中 讨论 
过 RecyclerView ， 如 果 你 以 前 没有 使 用 过 ， 它 可 能 会 有 所 帮助 。 


RecyclerView 中 所 使 用 到 的 布局 现在 只 需要 一 个 TextView ， 我 会 手动 去 创建 
这 个 简单 的 文本 列表 。 增 加 一 个 名 为 ForecastListAdapter ,kt 的 Kotlin 文 件 ， 包 
括 如 下 代码 : 


class ForecastListAdapter(val items: List<String>) 
RecyclerView.Adapter<ForecastListAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: 
Int): ViewHolder { 


return ViewHolder(TextView(parent.context) ) 
} 


override fun onBindViewHolder(holder: ViewHolder, position: 
Int) A 


holder.textView.text = items. [position] 


override fun getItemCount(): Int = items.size 


class ViewHolder(val textView: TextView) : RecyclerView.View 
Holder(textView) 


} 


又 是 如 此 ， 我 们 可 以 像 访问 属性 一 样 访问 context 和 text。 你 可 以 保持 以 往 那 样 操作 

(使 用 getters 和 setters) ,但 是 你 会 得 到 一 个 编译 器 的 警告 。 如 果 你 还 是 倾向 于 
Java 中 的 使 用 方式 ， 这 个 检查 可 以 被 关闭 。 但 是 一 旦 你 使 用 上 了 这 种 属性 调用 的 方 
式 你 就 会 爱 上 它 ， 而 且 它 也 节省 了 额外 的 字符 总 量 。 


回 到 MainActivity ， 现 在 简单 地 创建 一 系列 的 String 放 入 List 中 ， 然 后 使 用 创建 
分 配 Adapter 实 例 。 


The Recycler Adapter 


private val items = 1Listof( 
"Mon 6/23 - Sunny - 31/17", 
"Tue 6/24 - Foggy - 21/8", 
"Wed 6/25 - Cloudy - 22/17", 
“Thurs 6/26 = Rainy = 18/11", 
"Fri 6/27 - Foggy - 21/10", 
"Sat 6/28 - TRAPPED IN WEATHERSTATION - 23/18", 
"Sun 6/29 - Sunny - 20/7" 


) 


override fun onCreate(savediInstanceState: Bundle?) { 


val forecastList = findViewById(R.id.forecast_list) as Recyc 
lerView 

forecastList.layoutManager = LinearLayoutManager (this) 

forecastList.adapter = ForecastListAdapter(items) 


List 的 创建 
尽管 我 会 在 本 书后 面 来 对 Collection 进 行 讲 解 ， 但 是 我 现在 仅仅 简单 地 解释 
你 可 以 通过 使 用 一 个 函数 listof 创建 一 个 常量 的 List (很 快 我 们 就 会 讲 
到 的 immutable ) 。 它 接收 一 个 任何 类 型 的 vararg (可 变 长 的 参 
数 ) ， 它 会 自动 推断 出 结果 的 类 型 。 
ARS HEM BAT Vw > toto setof ， arrayListof 或 
者 hashSetof ° 


为 了 优化 项 目的 结构 ， 我 也 移动 了 一 些 类 到 新 的 包 里 面 。 


我 们 在 上 面 很 简短 的 代码 中 看 到 了 很 多 新 的 东西 ， 所 以 我 会 在 下 一 章 讲 到 它们 。 我 


们 现在 必须 要 学 习 一 些 比如 基本 类 型 ， 变 量 ， 属 性 等 比较 重要 的 概念 才能 继续 下 
Ea 


变量 和 属性 


在 Kotlin 中 ， 一 切 都 是 对 象 。 没 有 像 Java 中 那样 的 原始 基本 类 型 。 这 个 是 非常 有 
助 的 ， 因 为 我 们 可 以 使 用 一 致 的 方式 来 处 理 所 有 的 可 用 的 类 型 。 


A 


基本 类 型 


当然 ， 像 integer，float 或 者 boolean 等 类 型 仍然 存在 ， 但 是 它们 全 部 都 会 作为 对 象 
存在 的 。 基 本 类 型 的 名 字 和 它们 工作 方式 都 是 与 Java 非 常 相似 的 ， 但 是 有 一 些 不 同 
之 处 你 可 能 需要 考虑 到 : 
o 数字 类 型 中 不 会 自动 转型 。 举 个 例子 ， 你 不 能 给 Double 变量 分 配 一 
个 Int 。 必 须要 做 一 个 明确 的 类 型 转换 ， 可 以 使 用 众多 的 函数 之 一 : 


val i:Int=7 
val d: Double = i.toDouble() 


。 字符 (Char) 不 能 直接 作为 一 个 数字 来 处 理 。 在 需要 时 我 们 需要 把 他 们 转换 为 
一 个 数学 : 


valie- Char: cn 
val i: Int = c.toInt() 


e 位 运算 也 有 一 点 不 同 。 在 Android 中 ， 我 们 经 常 在 flags PERAR > TUR 
使 用 "and" 和 "or 来 举例 : 


// Java 
int bitwiseOr = FLAG1 | FLAG2; 
int bitwiseAnd = FLAG1 & FLAG2; 


// Kotlin 
val bitwiseOr = FLAG1 or FLAG2 
val bitwiseAnd = FLAG1 and FLAG2 


还 有 很 多 其 他 的 位 操作 符 ， 比 如 sh1 , shs, ushr , xor 或 inv ° FR 

们 需要 的 时 候 ， 可 以 在 Kotlin 官 网 查看 。 

e@ 字面 上 可 以 写 明 具体 的 类 型 。 这 个 不 是 必须 的 ， 但 是 一 个 通用 的 Kotlin 实 践 时 
省 略 变量 的 类 型 (我们 马上 就 能 看 到 ) ， 所 以 我 们 可 以 让 编译 器 自己 去 推断 出 


具体 的 类 型 。 


Vallee = 2 /A/ AT nite 

val iHex = Oxof // 一 个 十 六 进 制 的 Int 类 型 
val 1 = 3L // A Long 

val d = 3.5 // A Double 

val f 3.5F // A Float 


e 一 个 String 可 以 像 数 组 那样 访问 ， 并 且 被 迭代 : 


val s = "Example" 
val c = s[2] // &&—-*F 4 'a' 
MA 27.Str ing 
Val s = “Example” 
for (Ce in so 
print(c) 


亦 号 
L E 


变量 可 以 很 简单 地 定义 成 可 变 ( var ) 和 不 可 变 ( val ) 的 变量 。 这 个 与 Java 中 使 
用 的 final 很 相似 。 但 是 不 可 变 在 Kotlin (和 其 它 很 多 现代 语言 ) 中 是 一 个 很 重要 
的 概念 。 


一 个 不 可 变 对 象 意味 着 它 在 实例 化 之 后 就 不 能 再 去 改变 它 的 状态 了 。 如 果 你 需要 一 
个 这 个 对 象 修改 之 后 的 版 本 ， 那 就 会 再 创建 一 个 新 的 对 象 。 ee 
壮 性 和 预 估 性 。 在 Java 中 ， 大 部 分 的 对 象 是 可 变 的 ， 那 就 意味 着 任何 可 以 访问 它 这 
个 对 象 的 代码 都 可 以 去 修改 它 ， 从 而 影响 整个 程序 的 其 它 地 方 。 


不 可 变 对 象 也 可 以 说 是 线程 安全 的 ， 因 为 它们 无 法 去 改变 ， 也 不 需要 去 定义 访问 控 
制 ， 因 为 所 有 线程 访问 到 的 对 象 都 是 同一 个 。 


所 以 在 Kotlin 中 ， 如 果 我 们 想 使 用 不 可 变性 ， 我 们 编码 时 思考 的 方式 需要 有 一 些 改 
变 。 一 个 重要 的 概念 是 : 尽 可 能 地 使 用 val 。 除 了 个 别 情 况 (特别 是 在 Android 
中 ， 有 很 多 类 我 们 是 不 会 去 直接 调用 构造 函数 的 ) ， 大 多 数 时 候 是 可 以 的 。 


之 前 提 到 的 另 一 件 事 是 我 们 通常 不 需要 去 指明 类 的 类 型 ， 它 会 自动 从 后 面 分 配 的 语 
名 中 推断 出 来 ， 这 样 可 以 让 代码 更 加 清晰 和 快速 修改 。 我 们 在 前 面 已 经 有 了 一 些 例 
Fei 


val s = "Example" // A String 

val i = 23 // An Int 

val actionBar = supportActionBar // An ActionBar in an Activity 
context 


如 果 我 们 需要 使 用 更 多 的 范 型 类 型 ， 则 需要 指定 : 


val a: Any = 23 
val c: Context = activity 


属性 


属性 与 Java 中 的 字段 是 相同 的 ， 但 是 更 加 强大 。 属 性 做 的 事情 是 字段 加 上 getter 加 
上 setter。 我 们 通过 一 个 例子 来 比较 他 们 的 不 同 之 处 。 这 是 Java 中 字段 安全 访问 和 
修改 所 需要 的 代码 : 


public class Person { 
private String name; 
public String getName() { 
return name; 
} 
public void setName(String name) { 
this.name = name; 


Person person = new Person(); 
person.setName("name"); 
String name = person.getName(); 


在 Kotlin 中 ， 只 需要 一 个 属性 就 可 以 了 : 


public class Person { 
var name: String = "" 


val person = Person() 
person.name = "name" 
val name = person.name 


如 果 没 有 任何 指定 ， 属 性 会 默认 使 用 getter 和 setter。 当 然 它 也 可 以 修改 为 你 自 定义 
的 代码 ， 并 且 不 修改 存在 的 代码 : 


public classs Person { 
var name: String = "" 
get() = field. toUpperCase( ) 
set (value) { 
field = "Name: $value" 


如 果 需 要 在 getter 和 setter 中 访问 这 个 属性 自身 的 值 ， 它 需要 创建 一 个 backing 
field 。 可 以 使 用 field 这 个 预 留 字段 来 访问 ， 它 会 被 编译 器 找到 正在 使 用 的 并 
自动 创建 。 需 要 注意 的 是 ， 如 果 我 们 直接 调用 了 属性 ， 那 我 们 会 使 用 setter 和 getter 
而 不 是 直接 访问 这 个 属性 。 backing field 只 能 在 属性 访问 器 内 访问 。 


就 如 在 前 面 章节 提 到 的 ， 当 操作 Java 代 码 的 时 候 ，Kotlin 将 允许 使 用 属性 的 语法 去 
访问 在 Java 文 件 中 定义 的 getter/setter 方 法 。 编 译 器 会 直接 链接 到 它 原始 的 
getter/setter 方 法 。 所 以 当 我 们 直接 访问 属性 的 时 候 不 会 有 性 能 开销 。 


Anko 走 什么 ? 


Anko 是 JetBrains 开 发 的 一 个 强大 的 库 。 它 主要 的 目的 是 用 来 替代 以 前 XML 的 方式 

来 使 用 代码 生成 UI 布局。 这 是 一 个 很 有 趣 的 特性 ， 我 推荐 你 可 以 尝试 下 ， 但 是 我 在 
这 个 项 目 中 暂时 不 使 用 它 。 对 于 我 (可 能 是 由 于 多 年 的 UI 绘制 经 验 ) 来 说 使 用 XML 
更 容易 一 些 ， 但 是 你 会 喜欢 那 种 方式 的 。 


然而 ， 这 个 不 是 我 们 能 在 这 个 库 中 得 到 的 唯一 一 个 功能 。Anko 包 含 了 很 多 的 非常 有 
帮助 的 函数 和 属性 来 避免 让 你 写 很 多 的 模版 代码 。 我 们 将 会 通过 本 书 见 到 很 多 例 
子 ， 但 是 你 应 该 快速 地 认识 到 这 个 库 帮 你 解决 了 什么 样 的 问题 。 


尽管 Anko 是 非常 有 帮助 的 ， 但 是 我 建议 你 要 理解 这 个 背后 到 底 做 了 什么 。 你 可 以 在 
任何 时 候 使 用 ctrl + 点 击 (Windows) 或 者 cmd + 点 击 (Mac) 的 方式 跳 转 
到 Anko 的 源 代 码 。Anko 的 实现 方式 对 学 习 大 部 分 的 Kotlin 语 言 都 是 非常 有 帮助 的 。 


开始 使 用 Anko 


在 之 前 ， 让 我 们 来 使 用 Anko 来 简化 一 些 代码 。 就 像 你 将 看 到 的 ， 任 何 时 候 你 使 用 了 
Anko 库 中 的 某 些 东西 ， 它 们 都 会 以 属性 名 、 方 法 等 方式 被 导入 。 这 是 因为 Anko 使 
用 了 扩展 函数 在 Android 框 架 中 增加 了 一 些 新 的 功能 。 我 们 将 会 在 以 后 看 到 扩展 函 
数 是 什么 ， 怎 么 去 编写 它 。 

在 MainActivity:onCreate ， 一 个 Anko 扩 展 函 数 可 以 被 用 来 简化 获取 一 个 


RecyclerView : 


val forecastList: RecyclerView = find(R.id.forecast_list) 


我 们 现在 还 不 能 使 用 库 中 更 多 的 东西 ， 但 是 Anko 能 帮助 我 们 简化 代码 ， 比 如 ， 实 例 
化 Intent，Activity 之 间 的 跳 转 ，Fragment 的 创建 ， 数 据 库 的 访问 ，Alert 的 创建 .…… 
我 们 将 会 在 实现 这 个 App 的 过 程 中 学 习 到 很 多 有 趣 的 例子 。 


扩展 有 函数 


扩展 函数 数 是 指 在 一 个 类 上 增加 一 种 新 的 行为 ， 甚 至 我 们 没有 这 个 类 代码 的 访问 权 
限 。 这 是 一 个 在 缺少 有 用 函数 的 类 上 扩展 的 方法 。 在 Java 中 ， 通 常会 实现 很 多 带 有 
ee Kotlin 中 扩展 函数 的 一 个 优势 是 我 们 因 需要 在 调用 方法 的 时 候 

整个 对 象 当 作 参数 传 入 。 扩 展 函 数 表现 得 就 像 是 属于 这 个 类 的 一 样 ， 而 且 我 们 可 
ae this 关键 字 和 调用 所 有 public 方 法 。 


举 个 例子 ， 我 们 可 以 创建 一 个 toast 元 数 ， 这 个 函数 不 需要 传 入 任何 context， 它 可 以 
被 任何 Context 或 者 它 的 子 类 调用 ， a : 


fun Context.toast(message: CharSequence, duration: Int = Toast.L 
ENGTH_SHORT) { 
Toast .makeText(this, message, duration) .show() 


这 个 方法 可 以 在 Activity 内 部 直接 调用 : 


toast("Hello world!") 
toast("Hello world!", Toast.LENGTH_LONG) 


当然 ，Anko 已 经 包括 了 自己 的 toast 扩 展 函 数 ， 跟 上 面 这 个 很 相似 。Anko 提 供 了 一 
些 针 对 CharSequence 和 resource 的 函数 ， 还 有 两 个 不 同 的 toast 和 longToast 方 
法 : 


toast("Hello world!") 
longToast(R.id.hello_world) 


扩展 函数 也 可 以 是 一 个 属性 。 所 以 我 们 可 以 通过 相似 的 方法 来 扩展 属性 。 下 面 的 例 
子 展 示 了 使 用 他 自己 的 gettersetter 生 成 一 个 属性 的 方式 。 Kotlin 由 于 互 操作 性 的 特 
性 已 经 提供 了 这 个 属性 ， 但 理解 扩展 属性 背后 的 思想 是 一 个 很 不 错 的 练习 : 


public var TextView.text: CharSequence 
get() = getText() 
set(v) = setText(v) 
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数 可 以 被 声明 在 任何 文件 中 ， 因 此 有 个 通用 的 实践 是 把 一 系列 有 关 的 函数 放 在 一 个 
新 建 的 文件 里 。 


这 是 Anko 功 能 背后 的 魔法 。 现 在 通过 以 上 ， 你 也 可 以 自己 创建 你 的 魔法 。 


执行 一 个 请 求 


对 于 感受 我 们 要 实现 的 想法 而 言 ， 我 们 目前 的 文本 是 很 好 开始 ， 但 是 现在 是 时 候 去 
请 求 一 些 显示 在 RecyclerView 上 的 盖 正 的 数据 了 。 我 们 将 会 使 用 OpenWeatherMap 
API 来 获取 数据 ， 还 有 一 些 普通 类 来 现实 这 个 请 求 。 多 亏 Kotlin 非 常 强大 的 互 操作 
性 ， 你 可 以 使 用 任何 你 想 使 用 的 库 ， 比 如 用 Retrofit 来 执行 服务 器 请 求 。 当 只 是 执行 
一 个 简单 的 API 请 求 ， 我 们 可 以 不 使 用 任何 第 三 方 库 来 简单 地 实现 。 


而 且 ， 如 你 所 见 ，Kotlin 提 供 了 一 些 扩展 函数 来 让 请 求 变 得 更 简单 。 首 先 ， 我 们 要 
创建 一 个 新 的 Request 类 : 


public class Request(val url: String) { 
public fun run() { 
val forecastJsonStr = URL(url).readText() 
Log.d(javaClass.simpleName, forecastJsonStr ) 


我 们 的 请 求 很 简单 地 接收 一 个 url， 然 后 读 取 结 果 并 在 logcat 上 打印 json。 实 现 非 常 
简单 ， 因 为 我 们 使 用 readText ， 这 是 Kotlin 标 准 库 中 的 扩展 函数 。 这 个 方法 不 推 
荐 结果 很 大 的 响应 ， 但 是 在 我 们 这 个 例子 中 已 经 足够 好 了 。 


如 果 你 用 这 些 代 码 去 比较 Java， 你 会 发 现 我 们 仅 使 用 标准 库 就 节省 了 大 量 的 代码 。 
比如 HttpURLConnection ` BufferedReader 和 需要 达到 相同 效果 所 必要 的 迭 
代 结 果 ， 管 理 连接 状态 、reader 等 部 分 的 代码 。 很 明显 ， 这 些 就 是 场景 背后 函数 所 
作 的 事情 ， 但 是 我 们 却 不 用 关心 。 


为 了 可 以 执行 请 求 ，App 必 须要 有 Internet 权 限 。 所 以 需要 
在 AndroidManifest.xml 中 添加 : : 


<uses-permission android:name="android.permission. INTERNET" /> 


在 主线 程 以 外 执行 请 求 


如 你 所 知 ，HTTP 请 求 不 被 允许 在 主线 程 中 执行 ， 和 否则 它 会 抛 出 异常 。 这 是 因为 阻 

塞 住 Ul 线程 是 一 个 非常 差 的 体验 。Android 中 通用 的 做 法 是 使 用 AsyncTask ， 但 是 
这 些 类 是 非常 五 陋 的 ， 并 且 使 用 它们 无 任何 副作用 地 实现 功能 也 是 非常 困难 的 。 如 
果 你 使 用 不 小 心 ，AsyncTasks 会 非常 危险 ， 因 为 当 运 行 到 postExecute 时 ， 如 
果 Activity 已 经 被 销毁 了 ， 这 里 就 会 前 溃 。 


Anko 提 供 了 非常 简单 的 DSL 来 处 理 异 步 任 务 ， 它 满足 大 部 分 的 需求 。 它 提供 了 一 个 
基本 的 async 函数 用 于 在 其 它 线程 执行 代码 ， 也 可 以 选择 通过 调用 uiThread 的 
方式 回 到 主线 程 。 在 子 线程 中 执行 请 求 如 下 这 么 简单 : 


async() { 
Request(url).run() 
uiThread { longToast("Request performed") } 


UIThread 有 一 个 很 不 错 的 一 点 就 是 可 以 依赖 于 调用 者 。 如 果 它 是 被 一 
个 Activity 调用 的 ， 那 么 如 果 activity.isFinishing() 返回 true ， 
X) uiThread KAA > ARMAS “Activity AWAY HN ARB SY) MM AV TILT 。 


假如 你 想 使 用 Future 来 工作 ， async 返回 一 个 Java Future 。 而 且 如 果 你 需 
要 一 个 返回 结果 的 Future ， 你 可 以 使 用 asyncResult 。 


真 的 很 简单 ， 对 吧 ? 而 且 比 AsyncTasks 更 加 具有 可 读 性 。 现 在 ， 我 仅仅 给 请 求 
发 送 了 一 个 url， 来 测试 我 们 是 否 可 以 正确 接收 内 容 ， 这 样 我 们 才能 在 Activity 中 把 它 
画 出 来 。 我 很 快 会 讲 到 怎么 去 进行 json 解 本 和 转换 成 app 中 的 数据 类 ， 但 是 在 我 们 
继续 之 前 ， 学 习 什 么 是 数据 类 也 是 很 重要 的 。 


检查 代码 并 审查 url 请 求 和 包 结构 的 代码 。 你 可 以 运行 app 并 且 确 保 你 可 以 在 打印 的 
json 日 志和 请 求 完 毕 之 后 的 toast。 


数据 类 

数据 类 是 一 种 非常 强大 的 类 ， 它 可 以 让 你 避免 创建 Java 中 的 用 于 保存 状态 但 又 操作 
非常 简单 的 POJO 的 模版 代码 。 它 们 通常 只 提供 了 用 于 访问 它们 属性 的 简单 的 getter 
和 setter 。 定 义 一 个 新 的 数据 类 非常 简单 : 


data class Forecast(val date: Date, val temperature: Float, val 


details: String) 


额外 的 函数 


通过 数据 类 ， 我 们 可 以 方便 地 得 到 很 多 有 趣 的 函数 ， 一 部 分 是 来 自 属性 ， 我 们 之 前 
已 经 讲 过 《从 编写 getter 和 setter 函 数 ) 


e equals(): 它 可 以 比较 两 个 对 象 的 属性 来 确保 他 们 是 相同 的 。 

e hashCode(): 我 们 可 以 得 到 一 个 hash 值 ， 也 是 从 属性 中 计算 出 来 的 。 

© copy(): 你 可 以 拷贝 一 个 对 象 ， 可 以 根据 你 的 需要 去 修改 里 面 的 属性 。 我 们 会 在 
稍 后 的 例子 中 看 到 。 

© 一 系列 可 以 映射 对 象 到 变量 中 的 函数 。 我 也 很 快 就 会 讲 到 这 个 。 


复制 一 个 数据 类 


如 果 我 们 使 用 不 可 修改 的 对 象 ， 就 像 我 们 之 前 讲 过 的 ， 假 如 我 们 需要 修改 这 个 对 象 
状态 ， 必 须要 创建 一 个 新 的 一 个 或 者 多 个 属性 被 修改 的 实例 。 这 个 任务 是 非常 重复 
EL fi fay ; ie EAJ o 


举 个 例子 ， 如 果 我 们 需要 修改 Forecast 中 的 temperature (温度 ) ， 我 们 可 以 
么 做 : 


val f1 = Forecast(Date(), 27.5f, "Shiny day") 
val f2 = f1.copy(temperature = 30f) 


如 上 ， 我 们 拷贝 了 第 一 个 forecast 对 象 然 后 只 修改 了 temperature 的 属性 而 没有 
修改 这 个 对 象 的 其 它 状 态 。 


当 你 使 用 Java 类 时 小 心 “不 可 修改 性 ” 


如 果 你 决定 使 用 不 可 修改 来 工作 ， 你 需要 意识 到 Java 不 是 根据 这 种 思想 来 
设计 的 ， 在 某 些 情况 下 ， 我 们 仍然 可 以 修改 这 些 状态 。 在 上 一 个 例子 中 ， 
你 还 是 可 以 访问 Date 对 象 ， 然 后 改变 它 的 值 。 有 个 简单 〈 不 安全 ) OF 
法 是 记 住所 有 需要 修改 状态 的 对 象 作为 一 个 规则 ， 然 后 必要 的 时 候 去 找 贝 
一 份 。 


另外 一 个 方法 是 封装 这 些 类 。 你 可 以 创建 一 个 ImmutableDate 类 ， 它 封 
装 了 Date 并 且 不 允许 去 修改 它们 的 状态 。 决 定 哪 种 方式 取决 于 你 。 本 书 
中 ， 我 不 会 对 不 可 修改 性 太 限制 ， 所 以 我 不 会 去 为 一 些 危险 的 类 去 创建 一 


个 封装 类 。 


Ol 


映射 对 象 到 变量 中 


映射 对 象 的 每 一 个 属性 到 一 个 变量 中 ， 这 个 过 程 就 是 我 们 知道 的 多 声明 。 这 就 是 为 
什么 会 有 componentX 函数 被 自动 创建 。 使 用 上 面 的 Forecast 类 举 个 例子 : 


val f1 = Forecast(Date(), 27.5f, "Shiny day") 
val (date, temperature, details) = f1 


上 面 这 个 多 声明 会 被 编译 成 下 面 的 代码 : 


val date = f1.component1() 
val temperature = f1.component2() 
val details = f1.component3() 


这 个 特性 背后 的 逻辑 是 非常 强大 的 ， 它 可 以 在 很 多 情况 下 帮助 我 们 简化 代码 。 举 个 
例子 ， Map 类 含有 一 些 扩展 函数 的 实现 ， 人 允许 它 在 和 迭代 时 使 用 key 和 value : 


for ((key, value) in map) { 
Log.d("map", "key:$key, value: $value") 


转换 json 到 数据 类 


我 们 现在 知道 怎么 去 创建 一 个 数据 类 ， 那 我 们 开始 准备 去 解析 数据 。 在 date 包 
中 ， 创 建 一 个 名 为 ResponseClasses.kt 新 的 文件 ， 如 果 你 打开 第 8 章 中 的 url， 你 
可 以 看 到 json 文 件 整 个 结构 。 它 的 基本 组 成 包括 一 个 城市 ， 一 个 系列 的 天 气 预报 ， 
这 个 城市 有 id， 名 字 ， 所 在 的 坐标 。 每 一 个 天 气 预 报 有 很 多 信息 ， 比 如 日 期 ， 不 同 
的 温度 ， 和 一 个 由 描述 和 图 标的 id。 


在 我 们 当前 的 UI 中 ， 我 们 不 会 去 使 用 所 有 的 这 些 数 据 。 我 们 会 解析 所 有 到 类 里 面 ， 
因为 可 能 会 在 以 后 茶 些 情况 下 会 用 到 。 以 下 就 是 我 们 需要 使 用 到 的 类 : 


data class ForecastResult(val city: City, val list: List<Forecas 
t>) 
data class City(val id: Long, val name: String, val coord: Coord 
inates, 
Val country: String, val population: Int) 

data class Coordinates(val lon: Float, val lat: Float) 
data class Forecast(val dt: Long, val temp: Temperature, val pre 
ssure: Float, 

val humidity: Int, val weather: List<Weather> 


val speed: Float, val deg: Int, val clouds: 
Tht, 
val rain: Float) 
data class Temperature(val day: Float, val min: Float, val max: 
Float, 
val night: Float, val eve: Float, val morn 
: Float) 
data class Weather(val id: Long, val main: String, val descripti 
on: String, 
Val icon: String) 


El = a 


当 我 们 使 用 Gson 来 解析 json 到 我 们 的 类 中 ， 这 些 属性 的 名 字 必 须要 与 json 中 的 名 字 
一 样 ， 或 者 可 以 指定 一 个 serialised name (序列 化 名 称 ) 。 一 个 好 的 实践 是 ， 
大 部 分 的 软件 结构 中 会 根据 我 们 app 中 布局 来 解 耦 成 不 同 的 模型 。 所 以 我 喜欢 使 用 


转换 jSon 到 数据 类 


声明 简化 这 些 类 ， 因 为 我 会 在 app 其 它 部 分 使 用 它 之 前 解析 这 些 类 。 属 性 名 称 与 
json 结 果 中 的 名 字 是 完全 一 样 的 。 


现在 ， 为 了 返回 被 解析 后 的 结果 ， 我 们 的 Request 类 需要 进行 一 些 修改 。 它 将 仍 
然 只 接收 一 个 城市 的 zipcode 作为 参数 而 不 是 一 个 完整 的 Ur|， 因 此 这 样 变 得 更 加 
具有 可 读 性 。 现 在 ， 我 会 把 这 个 静态 的 url 放 在 一 个 companion object (伴随 对 
象 ) 中 。 如 果 我 们 之 后 还 要 对 该 API 增 加 更 多 请 求 ， 我 们 需要 提取 它 


Companion objects 


Kotlin 人 允许 我 们 去 定义 一 些 行为 与 静态 对 象 一 样 的 对 象 。 尽 管 这 些 对 象 可 以 
众所周知 的 模式 来 实现 ， 比 如 容易 实现 的 单 例 模 式 。 


我 们 需要 一 个 类 里 面 有 一 些 静 态 的 属性 、 常 量 或 者 函数 ， 我 们 可 以 使 
用 companion objecvt 。 这 个 对 象 被 这 个 类 的 所 有 对 象 所 共享 ， 就 像 
Java 中 的 静态 属性 或 者 方法 。 


以 下 是 最 后 的 代码 : 


public class ForecastRequest(val zipCode: String) { 
companion object { 
private val APP_ID = "15646a06818f61f 7b8d7823ca833e1ce" 


private val URL = "http://api.openweathermap.org/data/2. 
Sy 


"forecast/daily?mode=json&units=metric&cnt=7" 
private val COMPLETE_URL = "$URL&APPID=$APP_ID&q=" 


fun execute(): ForecastResult { 


val forecastJsonStr = URL(COMPLETE_URL + zipCode).readTe 
xt() 


return Gson().fromJson(forecastJsonStr, ForecastResult:: 
class.java) 


} 


记得 在 build.gradle 中 增加 你 需要 的 Gson 依 赖 : 


compile "com.google.code.gson:gson:2.4" 


转换 json 到 数据 类 
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构建 domain 屋 


我 们 现在 创建 一 个 新 的 包 作 为 domain 层 。 这 一 层 中 会 包含 一 些 Commands 的 实 
现 来 为 app 执 行 任务 。 


首先 ， 必 须要 定义 一 个 Command 


public interface Command<T> { 
fun execute(): T 


这 个 command 会 执行 一 个 操作 并 且 返 回 某 种 类 型 的 对 象 ， 这 个 类 型 可 以 通过 范 型 被 
指定 。 你 需要 知道 一 个 有 趣 的 概念 ， 一 切 kotlin 函 数 都 会 返回 一 个 值 。 如 果 没 有 指 
定 ， 它 就 默认 返回 一 个 unit 类 。 所 以 如 果 我 们 想 让 Command 不 返回 数据 ， 我 们 
可 以 指定 它 的 类 型 为 Unit © 

Kotlin 中 的 接口 比 Java (Java 8 以 前 ) 中 的 强大 多 了 ， 因 为 它们 可 以 包含 代码 。 但 
是 我 们 现在 不 需要 更 多 的 代码 ， 以 后 的 章节 中 会 仔细 讲 这 个 话题 。 


第 一 个 command 需 要 去 请 求 天 气 预 报 结构 然后 转换 结果 为 domain 类 。 下 面 这 些 类 
会 在 domain 类 中 被 定义 : 


data class Forecastlist(val city: String, val country: String, 
val dailyForecast:List<Forecast>) 


data class Forecast(val date: String, val description: String, v 
a aohe Int, 
val low: Int) 


当 更 多 的 功能 被 增加 ， 这 些 类 可 能 会 需要 在 以 后 被 审查 。 但 是 现在 这 些 类 对 我 们 来 
说 已 经 足够 了 。 


这 些 类 必须 从 数据 映射 到 我 们 的 domain 类 ， 所 以 我 接 下 来 需要 创建 一 


个 DataMapper 


public class ForecastDataMapper { 
fun convertFromDataModel(forecast: ForecastResult): Forecast 
List af 
return ForecastList(forecast.city.name, forecast.city.co 
untry, 
convertForecastListToDomain(forecast.list)) 
private fun convertForecastListToDomain(list: List<Forecast>) 


List<ModelForecast> { 
return list.map { convertForecastItemToDomain(it) } 
} 
private fun convertForecastItemToDomain(forecast: Forecast): 
ModelForecast { 
return ModelForecast(convertDate(forecast.dt), 
forecast.weather[9].description, forecast.temp.m 
ax.toInt(), 
forecast.temp.min.toInt()) 


private fun convertDate(date: Long): String { 
val df = DateFormat.getDateInstance(DateFormat.MEDIUM, L 
ocale.getDefault()) 
return df.format(date * 1000) 





当 我 们 使 用 了 两 个 相同 名 字 的 类 ， 我 们 可 以 给 其 中 一 个 指定 一 个 别名 ， 这 样 我 们 就 
不 需要 写 完整 的 包 名 了 : 


import com.antonioleiva.weatherapp.domain.model.Forecast as Mode 
lForecast 


这 些 代码 中 另 一 个 有 趣 的 是 我 们 从 一 个 forecast list ? 444% A domain model 的 方法 : 


return list.map { convertForecastItemToDomain(it) } 


这 一 条 语句， 我 们 就 可 以 循环 这 个 集合 并 且 返 回 一 个 转换 后 的 新 的 List。Kotlin 在 

List 中 提供 了 很 多 不 错 的 函数 操作 符 ， 它 们 可 以 在 这 个 List 的 每 个 item 中 应 用 这 个 操 
作 并 且 任 何方 式 转换 它们 e 这 是 Kotlin 其 中 一 个 强大 的 功能 。 我 们 很 
快 就 会 查看 所 有 不 同 的 操作 符 。 知 道 它们 的 存在 是 很 重要 的 ， 因 为 它们 要 方便 得 

多 ， 并 可 以 节省 很 多 时 间 和 模版 。 


现在 ， 编 写 命令 前 的 准备 就 绪 : 


class RequestForecastCommand(val zipCode: String) 
Command<ForecastList> { 
override fun execute(): ForecastList { 
val forecastRequest = ForecastRequest(zipCode) 
return ForecastDataMapper().convertFromDataModel ( 
forecastRequest.execute() ) 


在 UI 中 绘制 数据 


MainActivity 中 的 代码 有 些小 的 改动 ， 因 为 现在 有 丨 实 的 数据 需要 翅 充 到 
adapter 中 。 异 步调 用 需要 被 重 写成 : 


async() { 
val result = RequestForecastCommand("94043").execute() 
uiThread{ 
forecastList.adapter = ForecastListAdapter (result) 
} 
} 
Adapter 也 需要 被 修改 : 


class ForecastListAdapter(val weekForecast: ForecastList) 
RecyclerView.Adapter<ForecastListAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: 
TME): 
ViewHolder? { 
return ViewHolder (TextView(parent.getContext())) 


override fun onBindViewHolder (holder: ViewHolder, 
POSICION- iN 
with(weekForecast.dailyForecast[position]) { 
holder.textView.text = "$date - $description - $high 
/$low" 


override fun getItemCount(): Int = weekForecast.dailyForecas 
t.size 


class ViewHolder(val textView: TextView) : RecyclerView.View 
Holder(textView) 


} 


在 Ul 中 绘制 数据 


with % 2 


with 是 一 个 非常 有 用 的 函数 ， 它 包含 在 Kotlin 的 标准 库 中 。 它 接收 一 个 对 象 
和 一 个 扩展 函数 作为 它 的 参数 ， 然 后 使 这 个 对 得 扩展 这 个 函数 。 这 表示 所 
有 我 们 在 括号 中 编写 的 代码 都 是 作为 对 象 (第 一 个 参数 ) 的 一 个 扩展 函 
数 ， 我 们 可 以 就 像 作为 this 一 样 使 用 所 有 它 的 public 方 法 和 属性 。 当 我 们 针 
对 同一 个 对 象 做 很 多 操作 的 时 候 这 个 非常 有 利于 简化 代码 o 


在 这 一 章 中 有 很 多 新 的 代码 加 入 ， 所 以 检 出 库 中 的 代码 吧 。 
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操作 符 重 载 


Kotin 有 一 些 固定 数量 象征 性 的 操作 符 ， 我 们 可 以 在 任何 类 中 很 容易 地 使 用 它们 。 方 
法 是 创建 一 个 方法 ， 方 法 名 为 保留 的 操作 符 关键 字 ， 这 样 就 可 以 让 这 个 操作 符 的 行 
为 映射 到 这 个 方法 。 重 载 这 些 操作 符 可 以 增加 代码 可 读 性 和 简洁 性 。 


RAVE ATR 


Otis RA 


过 各 种 可 能 性 被 实现 。 


一 元 操作 符 


a-- 


操作 符 


二 元 操作 符 


a+b 
a-b 
a*b 
a/b 
a%b 
a..b 
ainb 
alin b 
a += b 
a -=b 
a*=b 
a/=b 
a%=b 


操作 符 


a.unaryPlus() 
a.unaryMinus() 
a.not() 

a.inc() 


a.dec() 


a.plus(b) 
a.minus(b) 
a.times(b) 
a.div(b) 
a.mod(b) 

a.range To(b) 
b.contains(a) 
!b.contains(a) 
a.plusAssign(b) 
a.minusAssign(b) 
a.timesAssign(b) 
a.divAssign(b) 
a.modAssign(b) 


和 对 应 方法 的 表 。 对 应 方法 必须 在 指 


定 的 类 中 


数组 操作 符 


操作 符 函数 
ali] a.get(i) 
ali, j] a.get(i, j) 
ali_1, ..., i_n] a.get(i_1, ..., i_n) 
ali] = b a.set(i, b) 
ali, j] = b a.set(i, j, b) 
ali_1, ..., i_n] = b a.set(i_1, ..., i_n, b) 
等 于 操作 符 
操作 符 函数 
a == a?.equals(b) ?: b === null 
al=b !(a?.equals(b) ?: b === null) 


相等 操作 符 有 一 点 不 同 ， 为 了 达到 正确 合适 的 相等 检查 做 了 更 复杂 的 转换 ， 因 为 要 
得 到 一 个 确切 的 函数 结构 比较 ， 不 仅仅 是 指定 的 名 称 。 方 法 必须 要 如 下 准确 地 被 实 
I: 


operator fun equals(other: Any?): Boolean 


操作 符 === 和 !== 用 来 做 身份 检查 (它们 分 别 是 Java 中 的 == 和 != ) > FH 
它们 不 能 被 重 载 。 


况 数 调用 

方法 调用 
a(i) a.invoke(i) 
a(i, j) a.invoke(i, j) 


a(i_1, ..., i_n) a.invoke(i_1, ..., i_n) 


操作 符 表 
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cal 


你 可 以 想象 ，Kotlin List 是 实现 了 数组 操作 符 的 ， 所 以 我 们 可 以 像 Java 中 的 数组 一 
样 访问 List 的 每 一 项 。 除 此 之 外 : 在 可 修改 的 List 中 ， 每 一 项 也 可 以 用 一 个 简单 的 方 
式 被 直接 设置 : 


val x = myList[2] 
myList[2] = 4 


如 果 你 还 记得 ， 我 们 有 一 个 叫 ForecastList 的 数据 类 ， 它 是 由 很 多 其 他 额外 的 信息 
组 成 的 。 有 趣 的 是 可 以 直接 访问 它 的 每 一 项 而 不 是 请 求 内 部 的 list 得 到 某 一 项 。 做 一 
个 完全 不 相关 的 事情 ， 我 要 去 实现 一 个 size() 方法 ， 它 能 稍微 能 简化 一 点 当前 的 
Adapter : 


data class ForecastList(val city: String, val country: String, 
val dailyForecast: List<Forecast>) { 
operator fun get(position: Int): Forecast = dailyForecast[po 
sition] 
fun size(): Int = dailyForecast.size 


WwW 


它 会 使 我 们 的 onBindViewHolder 更 简单 一 点 : 


override fun onBindViewHolder(holder: ViewHolder, 
position: Ine) 人 
with(weekForecast[position]) { 
holder.textView.text = "$date - $description - $high/$lo 


当然 还 有 getItemCount() 方法 : 


override fun getItemCount(): Int = weekForecast.size() 


例子 
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> > Æ 足 大 大 
扩展 有 函数 中 的 操作 符 
我 们 不 需要 去 扩展 我 们 自己 的 类 ， 但 是 我 需要 去 使 用 扩展 函数 扩展 我 们 已 经 存在 的 
类 来 让 第 三 方 的 库 能 提供 更 多 的 操作 。 几 个 例子 ， 我 们 可 以 去 像 访问 List 的 方式 去 


访问 ViewGroup 的 view : 


operator fun ViewGroup.get(position: Int): View = getChildAt(pos 
ition) 


现在 丨 的 可 以 非常 简单 地 从 一 个 ViewGroup 中 通过 position 得 到 一 个 view : 


val container: ViewGroup = find(R.id.container ) 
val view = container[2] 


#1 & J KKotlin for Android developers repository 去 查看 这 些 代码 。 


使 Forecast list™) 点 击 


作为 一 个 真正 的 app， 当 前 列表 的 每 一 个 item 布 局 应 该 做 一 些 工作 。 第 一 件 事 就 是 
创建 一 个 合适 的 XML， 能 符合 我 们 的 需要 就 行 。 我 们 希望 显示 一 个 图 标 ， 日 期 ， 描 
述 以 及 最 高 和 最 低温 度 。 所 以 让 我 们 创建 一 个 名 为 item _forecast.xml 的 
layout : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: padding="@dimen/spacing_xlarge" 
android: background="?attr/selectableItemBackground" 
android: gravity="center_vertical" 
android: orientation="horizontal"> 


<ImageView 
android: id="@+id/icon" 
android: layout_width="48dp" 
android: layout_height="48dp" 
tools:src="@mipmap/ic_launcher"/> 


<LinearLayout 
android: layout_width="0dp" 
android: layout_height="wrap_content" 
android: layout_weight="1" 
android: layout_marginLeft="@dimen/spacing_xlarge" 
android: layout_marginRight="@dimen/spacing_xlarge" 
android: orientation="vertical"> 


<TextView 
android: id="@+id/date" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: textAppearance="@style/TextAppearance.AppCompat. 


使 Forecast list 可 点击 


Medium" 
tools:text="May 14, 2015"/> 
<TextView 
android: id="@+id/description" 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: textAppearance="@style/TextAppearance.AppCompat. 
Caption" 
tools: text="Light Rain /> 
</LinearLayout> 
<LinearLayout 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: gravity="center_horizontal" 
android: orientation="vertical"> 
<TextView 
android: id="@+id/maxTemperature" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: textAppearance="@style/TextAppearance.AppCompat. 
Medium" 
tools: text="30"/> 
<TextView 
android: id="@+id/minTemperature" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: textAppearance="@style/TextAppearance.AppCompat. 
Caption" 
tools: text="15"/> 
</LinearLayout> 
</LinearLayout> 


Domain model 和 数据 映射 时 必须 生成 完整 的 图 标 uil， 所 以 我 们 可 以 这 样 去 加 载 


~ 
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data class Forecast(val date: String, val description: String, 
val high: Int; val low? Int, val iconUril: St 
ring) 


在 ForecastDataMapper 中 : 


private fun convertForecastItemToDomain( forecast: Forecast): Mod 
elForecast { 
return ModelForecast(convertDate(forecast.dt), 
forecast.weather[9].description, forecast.temp.max.t 
oInt(), 
forecast.temp.min.toInt(), generateIconUrl(forecast. 
weather[0].icon) ) 


} 


private fun generateIconUrl(iconCode: String): String 
= "http://openweathermap.org/img/w/$iconCode. png" 


我 们 从 第 一 个 请 求 中 得 到 图 标的 code， 用 来 组 成 完成 的 图 标 url。 加 载 图 片 最 简单 的 
方式 是 使 用 图 片 加 载 库 。 Picasso 是 一 个 不 错 的 选择 。 它 需要 加 
到 build.gradle 的 依赖 中 : 


compile "com.squareup.picasso:picasso:<version>" 


如 此 ，Adapter 也 需要 一 个 大 的 改动 了 。 还 需要 一 个 click listener， 我 们 来 定义 它 : 


public interface OnItemClickListener { 
operator fun invoke(forecast: Forecast) 


如 果 你 还 记得 上 一 课程 ， 当 被 调用 时 invoke 方法 可 以 被 省 略 。 所 以 我 们 来 使 用 它 


来 简化 。listener 可 以 被 以 下 两 种 方式 调用 : 


itemClick.invoke(forecast ) 
itemClick(forecast) 


ViewHolder 将 负责 去 缚 定 数据 到 新 的 View : 


Class ViewHolder(view: View, val itemClick: OnItemClickListener ) 


RecyclerView.ViewHolder(view) { 
private val iconView: ImageView 
private val dateView: TextView 
private val descriptionView: TextView 
private val maxTemperatureView: TextView 
private val minTemperatureView: TextView 


init { 
iconView = view.find(R.id.icon) 
dateView = view.find(R.id.date) 
descriptionView = view.find(R.id.description) 


maxTemperatureView = view.find(R.id.maxTemperature) 
minTemperatureView = view.find(R.id.minTemperature) 


fun bindForecast(forecast: Forecast) { 
with(forecast) { 
Picasso.with(itemView.ctx).load(iconUrl).into(iconVi 


ew) 
dateView.text = date 
descriptionView.text = description 
maxTemperatureView.text = "${high.toString()}" 
minTemperatureView.text = "${low.toString()}" 
itemView.setOnClickListener { itemClick(forecast) } 

} 
} 
} 


现在 Adapter 的 构造 方法 接收 一 个 itemClick 。 创 建 和 绑 定 数据 也 是 更 简单 : 


public class ForecastListAdapter(val weekForecast: ForecastList, 
val itemClick: ForecastListAdapter .OnItemClickListener ) 


RecyclerView.Adapter<ForecastListAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: 


TAE): 
ViewHolder { 
val view = LayoutInflater.from(parent.ctx) 
.inflate(R.layout.item_forecast, parent, false) 
return ViewHolder(view, itemClick) 
} 


override fun onBindViewHolder(holder: ViewHolder, position: 
int), £ 


holder .bindForecast(weekForecast[position] ) 


如 果 你 使 用 了 上 面 这 些 代码 ， parent.ctx 不 会 被 编译 成 功 。Anko 提 供 
扩展 函 II E 单 。 举 个 例子 ，activitys、fragments 以 及 其 它 包含 

了 ctx 这 个 属性 ， 通 过 ctx 这 个 属性 来 返回 context， 但 是 在 View 中 缺少 这 个 属 
性 。 所 以 我 们 要 创建 一 个 新 的 名 叫 ViewExtensions ,kt 文件 来 代 

4 ui.utils ， 然 后 增加 这 个 扩展 属性 : 


val View.ctx: Context 
get() = context 


从 现在 开始 ， 任 何 View 都 可 以 使 用 这 个 属性 了 。 这 个 不 是 必须 的 ， 因 为 你 可 以 使 用 
扩展 的 context 属 性 ， 但 是 我 觉得 如 果 我 们 使 用 ctx 的 话 在 其 它 类 中 也 会 更 有 连贯 
性 。 而 且 ， 这 是 一 个 很 好 的 怎么 去 使 用 扩展 属性 的 例子 。 


最 后 ，MainActivity 调 用 setAdapter， 最 后 结果 是 这 样 的 : 


forecastList.adapter = ForecastListAdapter(result, 
object : ForecastListAdapter .OnItemClickListener{ 
override fun invoke(forecast: Forecast) { 
toast(forecast.date) 


}) 


如 你 所 见 ， 创 建 一 个 匿名 内 部 类 ， 我 们 去 创建 了 一 个 实现 了 刚刚 创建 的 接口 的 对 
象 。 看 起 来 不 是 很 好 ， 对 吧 ? 这 是 因为 我 们 还 没 开始 试 使 用 另 一 个 强大 的 函数 式 编 
程 的 特性 ， 但 是 你 将 会 在 下 一 章 中 学 习 到 怎么 去 把 这 些 代码 转换 得 更 简单 。 


去 代码 库 中 更 新 新 的 代码 。U| 开 始 看 起 来 更 好 了 。 


Lambdas 


Lambda 表 达 式 是 一 种 很 简 ees ， 去 定义 一 个 匿名 函数 。Lambda 是 非常 有 用 
的 ， 因 为 它们 避免 我 们 去 写 一 些 包含 了 某 些 函数 的 抽象 类 或 者 接口 ， 然 后 在 类 中 去 
实现 它们 。 在 Kotlin ， e 男 一 个 函数 的 和 参数。 


简化 setOnClickListener() 


我 们 用 Android 中 非常 典型 的 例子 去 解释 它 是 怎么 工作 
的 : View.setOnClickListener() 方法 。 如 果 我 们 想 用 Java 的 方式 去 增加 点 击 
事件 的 回调 ， 我 首先 要 编写 一 个 OnClickListener 接口 : 


public interface OnClickListener { 
void onClick(View v); 


然后 我 们 要 编写 一 个 匿名 内 部 类 去 实现 这 个 接口 : 


view.setOnClickListener(new OnClickListener(){ 
@Override 
public void onClick(View v) { 
Toast .makeText(v.getContext(), "Click", Toast.LENGTH_SHO 
RT).show(); 
} 
}) 


我 们 将 把 上 面 的 代码 转换 成 Kotlin (44 f Anko“ toast 4 žk ) 


view.setOnClickListener(object : OnClickListener { 
override fun onClick(v: View) { 
toast ("Click") 


很 幸运 的 是 ，Kotlin 允 许 Java 库 的 一 些 优化 ，|nterface 中 包含 单个 函数 可 以 被 蔡 代 
为 一 个 函数 。 如 果 我 们 这 么 去 定义 了 ， 它 会 正常 执行 : 


fun setOnClickListener(listener: (View) -> Unit) 


一 个 lambda 表 达 式 通过 参数 的 形式 被 定义 在 箭头 的 左边 (被 圆 括号 包围 ) ， 然 后 在 
箭头 的 右边 返回 结果 值 。 在 这 个 例子 中 ， 我 们 接收 一 个 View， 然 后 返回 一 个 
Unit (没有 东西 ) 。 所 以 根据 这 种 思想 ， 我 们 可 以 把 前 面 的 代码 简化 成 这 样 


view.setOnClickListener({ view -> toast("Click")}) 


这 是 非常 棒 的 简化 ! SRR LT PAK AULA AUS OM REEN 
头 的 左边 指定 参数 ， 在 箭头 的 右边 返回 函数 执行 的 结果 。 如 果 左 边 的 参数 没有 使 用 
到 ， 我 们 甚至 可 以 省 略 左边 的 参数 : 


view.setOnClickListener({ toast("Click") }) 


如 果 这 个 函数 的 最 后 一 个 参数 是 一 个 函数 ， 我 们 可 以 把 这 个 函数 移动 到 圆 括 号 外 
面 : 


view.setOnClickListener() { toast("Click") } 


并 且 ， 最 后 ， 如 果 这 个 函数 只 有 一 个 参数 ， 我 们 可 以 省 略 这 个 圆 括 号 : 


view.setOnClickListener { toast("Click") } 


比 原 始 的 Java 代 码 简 短 了 5 倍 多 ， 并 且 更 加 容易 理解 它 所 做 的 事情 。 非 常 让 人 影响 
深刻 。 


ForecastListAdapter 的 click listener 
在 前 面 一 章 ， 我 这 么 艰苦 地 写 了 click listener 的 目的 就 是 更 好 的 在 这 一 章 中 进行 开 
发 。 然 而 现在 是 时 候 把 你 学 到 的 东西 用 到 实践 中 去 了 。 我 们 从 ForecastListAdapter 
中 删除 了 listener 接 口 ， 然 后 使 用 ambda 代 替 : 
public class ForecastListAdapter(val weekForecast: ForecastList, 
val itemClick: (Forecast) -> Un 


it) 


3% 4NitemClick BAEK —** forecast 参数 然后 不 返回 任何 东 
西 。 ViewHolder 中 也 可 以 这 么 修改 : 


class ViewHolder(view: View, val itemClick: (Forecast) -> Unit) 
其 它 的 代码 保持 不 变 。 仅 仅 改 变 MainActivity 


val adapter = ForecastListAdapter(result) { forecast -> toast(fo 
recast.date) } 


我 们 可 以 简化 最 后 一 如。 如 果 这 个 函数 只 接收 一 个 参数 ， 那 我 们 可 以 使 用 it 引 
用 ， 而 不 用 去 指定 左边 的 参数 。 所 以 我 们 可 以 这 么 做 : 


val adapter = ForecastListAdapter(result) { toast(it.date) } 


扩展 语言 


多 亏 这 些 改变 ， 我 们 可 以 去 创建 自己 的 builder 和 代码 块 。 我 们 已 经 在 使 用 一 些 
有 趣 的 函数 ， 比 如 with 。 如 下 简单 的 实现 : 


inline Tun == wLeh(ts DOOY Tat) => Unit) ft. body().5 


这 个 函数 接收 一 个 T 类 型 的 对 象 和 一 个 被 作为 扩展 函数 的 函数 。 它 的 实现 仅仅 是 
让 这 个 对 象 去 执行 这 个 函数 。 因 为 第 二 个 参数 是 一 个 函数 ， 所 以 我 们 可 以 把 它 放 在 
圆 括 号 外 面 ， 所 以 我 们 可 以 创建 一 个 代码 块 ， 在 这 这 个 代码 块 中 我 们 可 以 使 

用 this 和 直接 访问 所 有 的 public 的 方法 和 属性 : 


with(forecast) { 
Picasso.with(itemView.ctx).load(iconUrl).into(iconView) 
dateView.text = date 
descriptionView.text = description 
maxTemperatureView.text = "$high" 
minTemperatureView.text = "$low" 
itemView.setOnClickListener { itemClick(this) } 


内 联 函 数 


内 联 函 数 与 普通 的 函数 有 点 不 同 。 一 个 内 联 函 数 会 在 编译 的 时 候 被 蔡 换 

掉 ， 而 不 是 丨 正 的 方法 调用 。 这 在 一 些 情况 下 可 以 减少 内 存 分 配 和 运行 时 
开销 。 举 个 例子 ， 如 果 我 们 有 一 个 函数 ， 只 接收 一 个 函数 作为 它 的 参数 。 
如 果 是 一 个 普通 的 函数 ， 内 部 会 创建 一 个 含有 那个 函数 的 对 象 。 另 一 方 

面 ， 内 联 函 数 会 把 我 们 调用 这 个 函数 的 地 方 替换 掉 ， 所 以 它 不 需要 为 此 生 
成 一 个 内 部 的 对 象 。 


另 一 个 例子 : 我 们 可 以 创建 代码 块 只 提供 Lollipop 或 者 更 高 版 本 来 执行 


inline fun supportsLollipop(code: () -> Unit) { 
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { 
code() 


它 只 是 检查 版 本 ， 然 后 如 果 满 足 条 件 则 去 执行 。 现 在 我 们 可 以 这 么 做 : 


supportsLollipop { 
window. setStatusBarColor (Color .BLACK) 


举 个 例子 ，Anko 也 是 基于 这 个 思想 来 实现 Android Layout 的 DSL 化 。 你 也 可 
以 查看 Kotlin reference 中 使 用 DSL 来 编写 HTML 的 一 个 例子 。 


可 见 性 修饰 符 


Kotlin 中 这 些 修饰 符 是 与 我 们 Java 中 的 使 用 是 有 些 不 同 的 。 在 这 个 语言 中 默认 的 修 
饰 符 是 public ， 这 节约 了 很 多 的 时 间 和 字符 。 但 是 这 里 有 一 个 详细 的 解释 关于 在 
Kotlin 中 不 同 的 可 见 性 修饰 符 是 怎么 工作 的 。 


多 饰 符 


private 


private 修饰 符 是 我 们 使 用 的 最 限制 的 修饰 符 。 它 表示 它 只 能 被 自己 所 在 的 文件 
见 。 所 以 如 果 我 们 给 一 个 类 声明 为 private ， 我 们 就 不 能 在 定义 这 个 类 之 外 的 
文件 中 使 用 它 。 


另 一 方面 ， 如 果 我 们 在 一 个 类 里 面 使 用 了 private 修饰 符 ， 那 访问 权限 就 被 限制 
在 这 个 类 里 面 了 。 甚 至 是 继承 这 个 类 的 子 类 也 不 能 使 用 它 。 


所 以 一 等 公民 ， 类 、 对 象 、 接 口 ..……. (也 就 是 包 成 员 ) 如 果 被 定义 为 private ， 
那么 它们 只 会 对 被 定义 所 在 的 文件 可 见 。 如 果 被 定义 在 了 类 或 者 接口 中 ， 那 它们 只 
对 这 个 类 或 者 接口 可 见 


protected 


这 个 修饰 符 只 能 被 用 在 类 或 者 接口 中 的 成 员 上 。 一 个 包 成 员 不 能 被 定义 
A protected 。 定 义 在 一 个 成 员 中 ， 就 与 Java 中 的 方式 一 样 了 : 它 可 以 被 成 员 自 
己 和 继承 它 的 成 员 可 见 (比如 ， 类 和 它 的 子 类 ) © 


Internal 


如 果 是 一 个 定义 为 internal 的 包 成 员 的 话 ， 对 所 在 的 整个 module 可 见 。 如 果 
它 是 一 个 其 它 领 域 的 成 员 ， 它 就 需要 依赖 那个 领域 的 可 见 性 了 。 上 比如 ， 如 果 我 们 写 
了 一 个 private 类 ， 那 么 它 的 internal 修饰 的 函数 的 可 见 性 就 会 限制 与 它 所 在 
的 这 个 类 的 可 见 性 。 


我 们 可 以 访问 同一 个 module 中 的 internal 修饰 的 类 ， 但 是 不 能 访问 其 


它 module 的 。 


什么 是 module 


根据 Jetbrains 的 定义 ， 一 个 module 应 该 是 一 个 单独 的 功能 性 的 单位 ， 它 
应 该 是 可 以 被 单独 编译 、 运 行 、 测 试 、debug 的 。 根 据 我 们 项 目 不 同 的 模 
块 ， 可 以 在 Android Studio 中 创建 不 同 的 module 。 在 Eclipse 中 ， 这 
些 module 可 以 认为 是 在 一 个 workspace 中 的 不 同 的 project ° 


public 
你 应 该 可 以 才 想 到 ， 这 是 最 没有 限制 的 修饰 符 。 这 是 默认 的 修饰 符 ， 成 员 在 任何 地 


方 被 修饰 为 public ， 很 明显 它 只 限制 于 它 的 领域 。 一 个 定义 为 public 的 成 员 
被 包含 在 一 个 private 修饰 的 类 中 ， 这 个 成 员 在 这 个 类 以 外 也 是 不 可 见 的 。 


构造 器 


所 有 构造 函数 默认 都 是 public 的 ， 它 们 类 是 可 见 的 ， 可 以 被 其 它 地 方 使 用 。 我 们 
也 可 以 使 用 这 个 语法 来 把 构造 函数 修改 为 private 


class C private constructor(a: Int) { ... } 


润色 我 们 的 代码 


我 们 已 经 准备 好 使 用 public 来 进行 重 构 了 ， 但 是 我 们 还 有 很 多 其 它 细节 需要 修 
改 。 比 如 ， 在 RequestForecastCommand 中 ， 我 们 在 构造 函数 中 我 们 创建 的 属 
性 zipcode 可 以 定义 为 private 


class RequestForecastCommand(private val zipCode: String) 


所 作 的 事情 就 是 我 们 创建 了 一 个 不 可 修改 的 属性 zipCode， 它 的 值 我 们 只 能 去 得 
到 ， 不 能 去 修改 它 。 所 以 这 个 不 大 的 改动 让 代码 看 起 来 更 加 清晰 。 如 果 我 们 在 编写 
类 的 时 候 ， 你 觉得 某 些 属性 因为 是 什么 原因 不 能 对 别人 可 见 ， 那 就 把 它 定义 


为 private 。 


而 且 ， 在 Kotlin 中 ， 我 们 不 需要 去 指定 一 个 函数 的 返回 值 类 型 ， 它 可 以 让 编译 器 推 
断 出 来 。 举 个 省 略 返 回 值 类 型 的 例子 : 


data class ForecastList(...) { 


fun get(position: Int) dailyForecast [position] 


fun size() = dailyForecast.size() 


我 们 可 以 省 略 返回 值 类 型 的 典型 情景 是 当 我 们 要 给 一 个 函数 或 者 一 个 属性 赋值 的 时 
候 。 而 不 需要 去 写 代码 块 去 实现 。 


剩 下 的 修改 是 相当 简单 的 ， 你 可 以 在 代码 库 中 去 同步 下 来 。 


Kotlin Android Extensions 


另 一 个 Kotlin 园 队 研发 的 可 以 让 开发 更 简单 的 插件 是 Kotlin Android 

Extensions 。 当 前 仅仅 包括 了 view 的 绑 定 。 这 个 插件 自动 创建 了 很 多 的 属性 来 让 
我 们 直接 访问 XML 中 的 view。 这 种 方式 不 需要 你 在 开始 使 用 之 前 明确 地 从 布局 中 去 
找到 这 些 views。 


这 些 属性 的 名 字 就 是 来 自 对 应 view 的 id， 所 以 我 们 取 id 的 时 候 要 十 分 小 心 ， 因 为 它 
们 将 会 是 我 们 类 中 非常 重要 的 一 部 分 。 这 些 属性 的 类 型 也 是 来 自 XML 中 的 ， 所 以 我 
们 不 需要 去 进行 额外 的 类 型 转换 。 


Kotlin Android Extensions 的 一 个 优点 是 它 不 需要 在 我 们 的 代码 中 依赖 其 它 
额外 的 库 。 它 仅仅 由 插件 组 层 ， 需 要 时 用 于 生成 工作 所 需 的 代码 ， 只 需要 依赖 于 
Kotlin 的 标准 库 。 


那 它 背后 是 怎么 工作 的 ? 该 插件 会 代替 任何 属性 调用 函数 ， 比 如 获取 到 view 并 具有 

缓存 功能 ， 以 免 每 次 属性 被 调用 都 会 去 重新 获取 这 个 view。 需 要 注意 的 是 这 个 缓存 

装置 只 会 在 Activity 或 者 Fragment 中 才 有 效 。 如 果 它 是 在 一 个 扩展 函数 中 增 

这 个 缓存 就 会 被 跳 过 ， 因 为 它 可 以 被 用 在 activity 中 但 是 插件 不 能 被 修 
， 所 以 不 需要 再 去 增加 一 个 缕 存 功能 。 


怎么 去 使 用 Kotlin Android Extensions 


如 果 你 还 记得 ， 现 在 项 目 已 经 准备 好 去 使 用 Kotlin Android Extensions。 当 我 们 创建 
这 个 项 目 ， 我 们 就 已 经 在 build.gradle 中 增加 了 这 个 依赖 : 


buldscript{ 
repositories { 
jcenter() 


} 
dependencies { 
classpath "org.jetbrains.kotlin:kotlin-android-extension 
s:$kotlin_version" 


} 


唯一 一 件 需要 这 个 插件 做 的 事情 是 在 类 中 增加 一 个 特定 的 "手工 " import 来 使 用 这 
个 功能 。 我 们 有 两 个 方法 来 使 用 它 : 
Activities 或 者 Fragments 的 Android Extensions 


这 是 最 典型 的 使 用 方式 。 它 们 可 以 作为 activity 或 fragment 的 属性 是 可 以 被 
访问 的 。 属 性 的 名 字 就 是 XML 中 对 应 view 的 id。 

我 们 需要 使 用 的 import 784) VA kotlin.android.synthetic 开头 ， 然 后 加 上 我 
WERE E] Activity kg A XMLA F : 


import kotlinx.android.synthetic.activity_main. * 


此 后 ， 我 们 就 可 以 在 setContentView 被 调用 后 访问 这 些 view。 新 的 Android 
Studio 版 本 中 可 以 通过 使 用 include 标签 在 Activity 默 认 布 局 中 增加 内 诅 的 布局 。 
很 重要 的 一 点 是 ， 针 对 这 些 布局 ， 我 们 也 需要 增加 手工 的 import : 


import kotlinx.android.synthetic.activity_main. * 
import kotlinx.android.synthetic.content_main. * 


Views 的 Android Extensions 


前 面 说 的 使 用 还 是 有 局 限 性 的 ， 因 为 可 能 有 很 多 代码 需要 访问 XML 中 的 view。 比 
如 ， 一 个 自 定义 view 或 者 一 个 adapter。 举 个 例子 ， 绑 定 一 个 xml 中 的 view 到 另 一 个 


view °. 唯一 不 同 的 就 是 需要 import 
import kotlinx.android.synthetic.view_item. view. * 


如 果 我 们 需要 一 个 adapter， 比 如 ， 我 们 现在 要 从 inflater 的 View 中 访问 属性 : 


view. textView.text = "Hello" 


重 构 我 们 的 代码 


现在 是 时 候 使 用 kotlin Android Extensions 来 修改 我 们 的 代码 了 。 修 改 相当 
简单 。 


我 们 从 MainActivity 开始 。 我 们 当前 只 是 使 用 了 forecastList 的 
RecyclerView。 但 是 我 们 可 以 简化 一 点 代码 。 首 先 ， 为 activity_main XML 增加 
手工 import : 


import kotlinx.android.synthetic.activity_main. * 


之 前 说 过 ， 我 们 使 用 id 来 访问 views。 所 以 我 要 修改 Recyclerview 的 id， 不 使 用 
下 划 线 ， 让 它 更 加 适合 Kotlin 变 量 的 名 字 。XML 最 后 如 下 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent"> 
<android.support.v7.widget .RecyclerView 
android: id="@+id/forecastList" 
android: layout_width="match_parent" 
android: layout_height="match_parent"/> 
</FrameLayout> 


然后 现在 ， 我 们 可 以 不 需要 find 这 一 
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override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState ) 
setContentView(R.layout.activity_main) 
forecastList.layoutManager = LinearLayoutManager (this) 


这 已 经 是 最 小 的 简化 了 ， 因 为 这 个 布局 非常 简单 。 但 是 ForecastListAdapter 也 
可 以 从 这 个 插件 中 受益 。 这 里 你 可 以 使 用 一 个 装置 来 绑 定 这 些 属 性 到 View 中 ， 它 可 
以 帮助 我 们 移 除 所 有 ViewHolder 的 find 代码 。 


首先 ， 为 item forecast 增加 手工 导入 : 


import kotlinx.android.synthetic.item_forecast.view. * 


然后 现在 我 们 可 以 在 ViewHolder 中 使 用 包含 在 itemView 中 的 属性 。 实 际 上 你 
可 以 在 任何 view 中 使 用 这 些 属性 ， 但 是 很 显然 如 果 view 不 包含 要 获取 的 子 view 就 会 
FS Se o 
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现在 我 们 可 以 直接 访问 view 的 属性 了 : 
class ViewHolder(view: View, val itemClick: (Forecast) -> Unit) 


RecyclerView.ViewHolder(view) { 
fun bindForecast(forecast: Forecast) { 
with( forecast ) { 
Picasso.with(itemView.ctx).load(iconUrl).into(itemVi 


ew. icon) 
itemView.date.text = date 
itemView.description.text = description 
itemView.maxTemperature.text = "${high.toString()}" 
itemView.minTemperature.text = "${low.toString()}" 
itemView.onClick { itemClick(forecast) } 

} 
} 
} 


| 


Kotlin Android Extensions 插 件 帮 助 我 们 减少 了 很 多 模版 代码 ， 并 且 简 化 了 我 们 访问 
View 的 方式 。 从 库 中 检 出 最 新 的 代码 吧 。 


Application 单 例 化 和 属性 的 Delegated 


我 们 很 快要 去 实现 一 个 数据 库 ， 如 果 我 们 想 要 保持 我 们 代码 的 简洁 性 和 层次 性 〈 而 
不 是 把 所 有 代码 添加 到 Activity 中 ) ， 我 们 就 要 需要 有 一 个 更 简单 的 访问 application 
context 的 方式 。 


Applicaton 单 例 化 
按照 我 们 在 Java 中 一 样 创建 一 个 单 例 最 简单 的 方式 : 


class App : Application() { 
companion object { 
private var instance: Application? = null 
fun instance() = instance! ! 


} 


override fun onCreate() { 
super .onCreate() 
instance = this 


为 了 这 个 Application 实 例 被 使 用 ， 要 记得 在 AndroidManifest.xml 中 增加 这 
个 App 


<application 
android: allowBackup="true" 
android: icon="@mipmap/ic_launcher" 
android: label="@string/app_name" 
android: theme="@style/AppTheme" 
android: name="".ui.App"> 


</application> 


Android 有 一 个 问题 ， 就 是 我 们 不 能 去 控制 很 多 类 的 构造 函数 。 比 如 ， 我 们 不 能 初 
始 化 一 个 非 null 属 性 ， 因 为 它 的 值 需要 在 构造 函数 中 去 定义 。 所 以 我 们 需要 一 个 可 
null 的 变量 ， 和 一 个 返回 非 null 值 的 函数 。 我 们 知道 我 们 一 直 都 有 一 个 App 实例 ， 
但 是 在 它 调用 onCreate 之 前 我 们 不 能 去 操作 任何 事情 ， 所 以 我 们 为 了 安全 性 ， 我 
们 假设 instance() 函数 将 会 总 是 返回 一 个 非 null 的 app 实例 。 


但 是 这 个 方案 看 起 来 有 点 不 自然 。 我 们 需要 定义 个 一 个 属性 (已 经 有 了 getter 和 


setter) ， 然 后 通过 一 个 函数 来 返回 那个 属性 。 age 到 相似 的 效果 
么 ?是 的 ， 我 们 可 以 通过 委托 这 个 属性 的 值 给 另外 一 个 类 。 这 个 就 是 我 们 知道 


Applicaton 单 例 化 


的 委托 属性 。 
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委托 属性 


我 们 可 能 需要 一 个 属性 具有 一 些 相 同 的 行为 ， 使 用 lazy 或 者 observable 可 以 
被 很 有 趣 地 实现 重用 。 而 不 是 一 次 又 一 次 地 去 声明 那些 相同 的 代码 ，Kotlin 提 供 了 
一 个 委托 属性 到 一 个 类 的 方法 。 这 就 是 我 们 知道 的 委托 属性 。 


当 我 们 使 用 属性 的 get 或 者 set 的 时 候 ， 属 性 委托 
的 getValue 和 setValue 就 会 被 调用 。 


属性 委托 的 结构 如 下 : 


class Delegate<T> : ReadWriteProperty<Any?, T> { 
fun getValue(thisRef: Any?, property: KProperty<*>): T { 


return at 
} 
fun setValue(thisRef: Any?, property: KProperty<*>, value: T) 
{ 
} 
} 


al Sa | 


这 个 T 是 委托 属性 的 类 型 。 getvalue 函数 接收 一 个 类 的 引用 和 一 个 属性 的 元 数 
据 。 setValue 函数 又 接收 了 一 个 被 设置 的 值 。 如 果 这 个 属性 是 不 可 修改 
(val) ， 就 会 只 有 一 个 getValue BAX 


下 面 展示 属性 委托 是 怎么 设置 的 : 


class Example { 
var p: String by Delegate() 


它 使 用 了 by 这 个 关键 字 来 指定 一 个 委托 对 象 。 


委托 属性 
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标准 委托 


在 Kotlin 的 标准 库 中 有 一 系列 的 标准 委托 。 它 们 包括 了 大 部 分 有 用 的 委托 ， 但 是 我 
们 也 可 以 创建 我 们 自己 的 委托 。 


Lazy 


它 包 含 一 个 lambda ， 当 第 一 次 执行 getValue 的 时 候 这 个 lambda 会 被 调用 ， 所 以 
这 个 属性 可 以 被 延迟 初始 化 。 之 后 的 调用 都 只 会 返回 同一 个 值 。 这 是 非常 有 趣 的 特 
性 ， 当 我 们 在 它们 第 一 次 览 正 调用 之 前 不 是 必须 需要 它们 的 时 候 。 我 们 可 以 节省 内 
存 ， 在 这 些 属性 卜 正 需要 前 不 进行 初始 化 。 


class App : Application() { 
val database: SQLiteOpenHelper by lazy { 
MyDatabaseHelper (applicationContext ) 


} 
override fun onCreate() { 

super .onCreate() 

val db = database.writableDatabase 
} 


在 这 个 例子 中 ，database 并 没有 被 真正 初始 化 ， 直 到 第 一 次 调用 onCreate 时 。 
在 那 之 后 ， 我 们 才 确 保 applicationContext 存 在 ， 并 且 已 经 准备 好 可 以 被 使 用 
To lazy 操作 符 是 线程 安全 的 。 


如 果 你 不 担心 多 线程 问题 或 者 想 提高 更 多 的 性 能 ， 你 也 可 以 使 
用 lazy(LazyThreadSafeMode.NONE){ ... } ° 
Observable 


这 个 委托 会 帮 有 我 们 监测 我 们 希望 观察 的 属性 的 变化 。 当 被 观察 属性 的 set 方法 被 
调用 的 时 候 ， 它 就 会 自动 执行 我 们 指定 的 lambda 表 达 式 。 所 以 一 旦 该 属性 被 赋 了 新 
的 值 ， 我 们 就 会 接收 到 被 委托 的 属性 、 昌 值 和 新 值 。 


class ViewModel(val db: MyDatabase) { 
var myProperty by Delegates.observable("") { 
d, old, new -> 
db.saveChanges(this, new) 


这 个 例子 展示 了 ， 一 些 我 们 需要 关心 的 ViewMode， 每 次 值 被 修改 了 ， 就 会 保存 它 
们 到 数据 库 。 


Vetoable 


这 是 一 个 特殊 的 observable ， 它 让 你 决定 是 否 这 个 值 需要 被 保存 。 它 可 以 被 用 
于 在 丨 正 保存 之 前 进行 一 些 条 件 判 断 。 


var positiveNumber = Delegates.vetoable(0) { 
d, old, new -> 
new >= 0 


上 面 这 个 委托 只 多 许 在 新 的 值 是 正 数 的 时 候 执行 保存 。 在 lambda 中 ， 最 后 一 行 表示 
返回 值 。 你 不 需要 使 用 return 关 键 字 (实质 上 不 能 被 编译 ) 。 


Not Null 


有 时 候 我 们 需要 在 某 些 地 方 初始 化 这 个 属性 ， 但 是 我 们 不 能 在 构造 函数 中 确定 ， 或 
者 我 们 不 能 在 构造 函数 中 做 任何 事情 。 第 二 种 情况 在 Android 中 很 常见 : 在 

Activity ` fragment ` service ` receivers...... 无 论 如 何 ， 一 个 非 抽 象 的 属性 在 构造 函 
数 执行 完 之 前 需要 被 赋值 。 为 了 给 这 些 属性 赋值 ， 我们 无 法 让 它 一 直 等 待 到 我 们 希 
望 给 它 赋值 的 时 候 。 我 们 至 少 有 两 种 选择 方案 。 

第 一 种 就 是 使 用 可 null 类 型 并 且 赋 值 为 null， 直 到 我 们 有 了 申 正 想 赋 的 值 。 但 是 我 们 


就 需要 在 每 个 地 方 不 管 是 否 是 null 都 要 去 检查 。 如 果 我 们 确定 这 个 属性 在 任何 我 们 
使 用 的 时 候 都 不 会 是 null， 这 可 能 会 使 得 我 们 要 编写 一 些 必 要 的 代码 了 。 


第 二 种 选择 是 使 用 notNull 委托 。 ee eens 
属性 的 时 候 分 配 一 个 趴 实 的 值 。 如 果 这 个 值 在 被 获取 之 前 没有 被 分 配 ， 它 就 会 抛 出 
一 个 异常 


这 个 在 单 例 App 这 个 例子 中 很 有 用 : 


Class App : Application() { 
companion object { 
var instance: App by Delegates.notNull() 


override fun onCreate() { 
super .onCreate() 
instance = this 


从 Map 中 映射 值 


另外 一 种 属性 委 人 > 属性 的 值 会 从 一 个 map 中 获取 value， 属 性 的 名 字 对 应 
这 个 map 中 的 key。 这 个 委托 可 以 让 我 们 做 一 些 很 强大 的 事情 ， 因 为 我 们 可 以 很 简 
单 地 从 一 个 动态 地 map 中 创建 一 个 对 象 实 例 。 如 果 我 们 import 
kotlin.properties.getValue ， 我 们 可 以 从 构造 函数 映射 到 val 属性 来 得 到 
一 个 不 可 修改 的 map。 如 果 我 们 想 去 修改 map 和 属性 ， 我 们 也 可 以 import 
kotlin.properties.setValue 。 类 需要 一 个 MutableMap 作为 构造 函数 的 参 
数 。 


想象 我 们 a OM ae 了 一 个 配置 类 ， 然 后 分 配 它 们 的 key 和 value 到 一 个 map 
中 。 我 们 可 以 仅仅 通过 传 入 一 个 map 的 构造 函数 来 创建 一 个 实例 : 


import kotlin.properties.getValue 


class Configuration(map: Map<String, Any?>) { 
val width: Int by map 
val height: Int by map 
val dp: Int by map 
val deviceName: String by map 


作为 一 个 参考 ， 这 里 我 展示 下 对 于 这 个 类 怎么 去 创建 一 个 必须 要 的 map : 


conf = Configuration(mapOf ( 
"width" to 1080, 
"height to 720, 
dpt to 240, 
"deviceName" to "mydevice" 


)) 


怎么 去 创建 一 个 自 定 义 的 委托 


先 来 说 说 我 们 要 实现 什么 ， 举 个 例子 ， 我 们 创建 一 个 notnull 的 委托 ， 它 只 能 被 
赋值 一 次 ， 如 果 第 二 次 赋值 ， 它 就 会 抛 异常 。 


Kotlin 库 提供 了 几 个 接口 ， 我 们 自己 的 委托 必须 要 实 
现 : ReadOnlyProperty 和 ReadwriteProperty 。 上 有 具体 取决 于 我 们 被 委托 的 对 


象 是 val 还 是 var 。 


我 们 要 做 的 第 一 件 事 就 是 创建 一 个 类 然后 继承 ReadwriteProperty 


private class NotNullSingleValueVar<T>() : ReadWriteProperty<Any 
pT 
t 


override fun getValue(thisRef: Any?, property: KProperty 
cel) Wr ier | 
throw UnsupportedOperationException() 


override fun setValue(thisRef: Any?, property: KProperty 
<*>, Value: T) {f 


} 


这 个 委托 可 以 作用 在 任何 非 null 的 类 型 。 它 接收 任何 类 型 的 引用 ， 然 后 像 getter 和 
setter 那 样 使 用 T。 现 在 我 们 需要 去 实现 这 些 函 数 。 


e Getter BR 如 果 已 经 被 初始 化 ， 则 会 返回 一 个 值 ， 否则 会 抛 异 常 。 
e Setter SR 如 果 仍 然 是 null， 则 赋值 ， 否 则 会 抛 弄 常 


private class NotNullSingleValueVar<T>() : ReadWriteProperty<Any 
2, 12 4 
private var value: T? = null 
override fun getValue(thisRef: Any?, property: KProperty<*>) 
APE 
return value ?: throw IllegalStateException("${desc.name 
mo A ap 


"not initialized") 


override fun setValue(thisRef: Any?, property: KProperty<*>, 
value: T) { 
this.value = if (this.value == null) value 
else throw IllegalStateException("${desc.name} already i 
nitialized") 


} 


现在 你 可 以 创建 一 个 对 象 ， 然 后 添加 函数 使 用 你 的 委托 : 


object DelegatesExt { 
fun notNullSingleValue<T>(): 
ReadWriteProperty<Any?, T> = NotNullSingleValuevVar ( ) 


重新 实现 Application 单 例 化 


在 这 景 下 ， 委 托 就 可 以 帮助 我 们 了 。 我 们 直到 我 们 的 单 例 不 会 是 null， 但 是 我 
oo 。 所 以 我 们 可 以 使 用 notNull 委托 : 


class App : Application() { 
companion object { 
var instance: App by Delegates.notNull() 


override fun onCreate() { 
super .onCreate() 
instance = this 


这 种 情况 下 有 个 问题 ， 我 们 可 以 在 app 的 任何 地 方 去 修改 这 个 值 ， 因 为 如 果 我 们 使 
用 有 notNull() ， 属 性 必须 是 var 的 。 但 是 我 们 可 以 使 用 刚刚 创建 的 委 
托 ， 这 样 可 以 多 一 点 保护 。 我 们 只 能 修改 这 个 值 一 次 : 


companion object { 
var instance: App by DelegatesExt.notNullSingleValue( ) 


} 
尽管 ， 在 这 个 例子 中 ， 使 用 单 例 可 能 是 最 简单 的 方法 ， 但 是 我 想 用 代码 的 形式 展示 
给 你 怎么 去 创建 一 个 自 定义 的 委托 。 


创建 一 个 SQLiteOpenHelper 


如 你 所 知 ，Android 使 用 SQLite 作 为 它 的 数据 库 管 理 系统 。SQLite 是 一 个 睹 入 app 的 
一 个 数据 库 ， 它 的 确 是 非常 轻 量 的 。 这 就 是 为 什么 这 是 手机 app 的 不 错 的 选择 。 


尽管 如 此 ， 它 的 操作 数据 库 的 API 在 Android 中 是 非常 原生 的 。 你 将 会 需要 编写 很 多 
SQL 语句 和 你 的 对 象 与 ContentValues 或 者 Cursors 之 间 的 解析 过 程 。 很 感激 
的 ， 联 合 使 用 Kotlin 和 Anko， 我 们 可 以 大 量 简化 这 些 。 

当然 ， 有 很 多 Android 中 可 以 使 用 的 关于 数据 库 的 库 ， 多 却 Kotlin 的 互 操作 性 ， 所 有 
这 些 库 都 可 以 正常 使 用 。 但 是 针对 一 个 简单 的 数据 库 来 说 可 以 不 使 用 任何 它们 ， 之 
后 的 一 分 钟 之 内 你 就 可 以 看 到 。 


ManagedSqliteOpenHelper 


Anko 提 供 了 很 多 强大 的 SqliteOpenHelper 来 可 以 大 量 简化 代码 。 当 我 们 使 用 一 个 一 
般 的 SqliteOpenHelper ， 我 们 需要 去 调用 getReadableDatabase() 或 

者 getWritableDatabase() ， 然 后 我 们 可 以 执行 我 们 的 搜索 并 拿 到 结果 。 在 这 之 
后 ， 我 们 不 能 忘记 调用 close() 。 使 用 ManagedSqliteOpenHelper 我 们 只 需 
$: 


forecastDbHelper.use { 


在 lambda 里 面 ， 我 们 可 以 直接 使 用 SqliteDatabase 中 的 函数 。 它 是 怎么 工作 
的 ? 阅读 Anko 哆 数 的 实现 方式 丨 是 一 件 有 趣 的 事情 ， 你 可 以 从 这 里 学 到 Kotlin 的 很 
y SJ 

多 知识 : 


public fun <T> use(f: SQLiteDatabase.() -> T): T { 
Emmy A 
return openDatabase().f() 
mausly 
closeDatabase() 


首先 ， use 接收 一 个 SQLiteDatabase 的 扩展 函数 。 这 表示 ， 我 们 可 以 使 
用 this 在 大 括号 中 ， 并 且 处 于 SQLiteDatabase 对 象 中 。 这 个 函数 扩展 可 以 返 
回 一 个 值 ， 所 以 我 们 可 以 像 这 么 做 : 


val result = forecastDbHelper.use { 
val queriedObject =... 
queriedObject 


要 记 住 ， 在 一 个 函数 中 ， 最 后 一 行 表 示 返 回 值 。 因 为 T 没 有 任何 的 限制 ， 所 以 我 们 
可 以 返回 任何 对 象 。 甚 至 如 果 我 们 不 想 返 回 任何 值 就 使 用 Unit ° 


由 于 使 用 了 try-finally ， use 方法 会 确保 不 管 在 数据 库 操作 执行 成 功 还 是 失 
败 都 会 去 关闭 数据 库 。 


而 有 全 ， 在 sqliteDatabase 中 还 有 很 多 有 用 的 扩展 函数 ， 我 们 会 在 之 后 使 用 到 他 
们 。 但 是 现在 让 我 们 先 定义 我 们 的 表 和 实现 SqliteOpenHelper ° 


定义 表 


创建 几 个 objects 可 以 让 我 们 避免 表 名 列 名 拼写 错误 、 重 复 等 。 我 们 需要 两 个 
表 : 一 个 用 来 保存 城市 的 信息 ， 另 一 个 用 来 保存 某 天 的 天 气 预报 。 第 二 张 表 会 有 一 
个 关联 到 第 一 张 表 的 字段 。 


CityForecastTable 提供 了 表 的 名 字 还 有 需要 列 : 一 个 id (这 个 城市 的 
zipCode) ， 城 市 的 名 称 和 所 在 国家 。 


object CityForecastTable { 
val NAME = "CityForecast" 
val ID = "_id" 
val GIV a oc rey 
val COUNTRY = "country" 


DayForecast 有 更 多 的 信息 ， 就 如 你 下 面 看 到 的 有 很 多 的 列 。 最 后 一 
A) cityId ， 用 来 保持 属于 的 城市 id © 


object DayForecastTable { 
val NAME = "DayForecast" 
val ID = "_id" 
val DATE = "date" 
val DESCRIPTION = "description" 
val HIGH = "high" 
val LOW = "low" 
val ICON_URL = "iconUr1" 
Val CITY ID <= “cityid™ 


实现 SqliteOpenHelper 


我 们 SqliteOpenHelper 的 基本 组 成 是 数据 库 的 创建 和 更 新 ， 并 提供 了 一 
个 SqliteDatebase ， 使 得 我 们 可 以 用 它 来 工作 。 查 询 可 以 被 抽取 出 来 放 在 其 它 
的 类 中 : 


class ForecastDbHelper() : ManagedSQLiteOpenHelper (App.instance, 
ForecastDbHelper.DB_NAME, null, ForecastDbHelper.DB_VERS 
ION) { 


我 们 在 前 面 的 章节 中 使 用 过 我 们 创建 的 App.instance ， 这 次 我 们 同样 的 包括 数 
据 库 名 称 和 版 本 。 这 些 值 我 们 都 会 与 SqliteOpenHelper 一 起 定义 在 companion 
object 中 : 


companion object { 
val DB_NAME = "forecast.db" 
val DB_VERSION = 1 
val instance: ForecastDbHelper by lazy { ForecastDbHelper( ) 


instance 这 个 属性 使 用 了 lazy 1° CAREA) C ARAA TARA © 
用 这 种 方法 ， 如 果 数 据 库 从 来 没有 被 使 用 ， 我 们 没有 必要 去 创建 这 个 对 象 。 一 

AK lazy 委托 的 代码 块 可 以 阻止 在 多 个 不 同 的 线程 中 创建 多 个 对 象 。 这 个 只 会 发 生 
在 两 个 线程 在 同事 时 间 访 问 这 个 instance 对 象 ， 它 很 难 发 生 但 是 发 生 具 体 还 有 看 
app 的 实现 。 无 人 如 何 ， lazy 委托 是 线程 安全 的 。 


为 了 去 创建 这 些 定义 的 表 ， 我 们 需要 去 提供 一 个 onCreate 函数 的 实现 。 当 没有 库 
使 用 的 时 候 ， 创 建 表 会 通过 我 们 编写 原生 的 包含 我 们 定义 好 的 列 和 类 型 的 CREATE 
TABLE 语句 来 实现 。 然 而 Anko 提 供 了 一 个 简单 的 扩展 函数 ， 它 接收 一 个 表 的 名 字 

和 一 系列 由 列 名 和 类 型 构建 的 Pair 对 象 : 


db.createTable(CityForecastTable.NAME, true, 
Pair(CityForecastTable.ID, INTEGER + PRIMARY_KEY), 
Pair(CityForecastTable.CITY, TEXT), 
Pair(CityForecastTable.COUNTRY, TEXT) ) 


© 第 一 个 参数 是 表 的 名 称 
e 第 二 个 参数 ， 当 是 true 的 时 候 ， 创 建 之 前 会 检查 这 个 表 是 否 存在 。 
° T ATE Pair 类 型 的 vararg 参数 。 EEE va > 
这 是 一 种 在 一 个 函数 中 传 入 联系 很 多 相同 类 型 的 参数 。 这 个 函数 也 接收 一 个 对 
象 数组 。 


Anko 中 有 一 种 叫做 SqlType 的 特殊 类 型 ， jie. a ly 混合 ， 
比如 PRIMARY_KEY ° + 操作 符 像 之 前 那样 被 重 写 个 plus 函数 会 把 两 者 
通过 合适 的 方式 结合 起 来 ， 然 后 返回 一 个 新 的 Sqltype 


fun SglType.plus(m: SqlTypeModifier) : SqlType { 
return SqlTypeImpl(name, if (modifier == null) m.toString() 
else "$modifier $m") 


如 你 所 见 ， 她 会 把 多 个 修饰 符 组 合 起 来 。 
但 是 回 到 我 们 的 代码 ， 我 们 可 以 修改 得 更 好 。Kotlin 标 准 库 中 包含 了 一 个 叫 to 的 
函数 ， 又 一 次 ， 让 我 们 来 展示 Kotlin 的 强大 之 处 。 它 作为 第 一 参数 的 扩展 函数 ， 接 
收 另 外 一 个 对 象 作 为 参数 ， 把 两 者 组 装 并 返回 一 个 Pair 。 

public fun <A, B> A.to(that: B): Pair<A, B> = Pair(this, that) 


因为 带 有 一 个 函数 参数 的 函数 可 以 被 用 于 inline， 所 以 结果 非常 清晰 : 


val pair = objecti to object2 


然后 ， 把 他 们 应 用 到 表 的 创建 中 : 


db.createTable(CityForecastTable.NAME, true, 
CityForecastTable.ID to INTEGER + PRIMARY_KEY, 
CityForecastTable.CITY to TEXT, 
CityForecastTable.COUNTRY to TEXT) 


这 就 是 整个 函数 看 起 来 的 样子 : 


override fun onCreate(db: SQLiteDatabase) { 
db.createTable(CityForecastTable.NAME, true, 
CityForecastTable.ID to INTEGER + PRIMARY_KEY, 
CityForecastTable.CITY to TEXT, 
CityForecastTable.COUNTRY to TEXT) 


db.createTable(DayForecastTable.NAME, true, 

DayForecastTable.ID to INTEGER + PRIMARY_KEY + AUTOI 

NCREMENT, 
DayForecastTable.DATE to INTEGER, 
DayForecastTable.DESCRIPTION to TEXT, 
DayForecastTable.HIGH to INTEGER, 
DayForecastTable.LOW to INTEGER, 
DayForecastTable.ICON_URL to TEXT, 
DayForecastTable.CITY_ID to INTEGER) 


我 们 有 一 个 相似 的 函数 用 于 删除 表 。 onUpgrade 将 只 是 删除 表 ， 然 后 重建 它们 。 
我 们 只 是 把 我 们 数据 库 作为 一 个 缓存 ， 所 以 这 是 一 个 简单 安全 的 方法 保证 我 们 的 表 
会 如 我 们 所 期 望 的 那样 被 重建 。 如 果 我 有 很 重要 的 数据 需要 保留 ， 我 们 就 需要 优 
化 onUpgrade 的 代码 ， 让 它 根 据 数据 库 版 本 来 做 相应 的 数据 转移 。 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newV 
ersion Int) < 
db.dropTable(CityForecastTable.NAME, true) 
db.dropTable(DayForecastTable.NAME, true) 
onCreate(db) 
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依赖 注入 


我 试图 不 去 增加 很 复杂 的 结构 代码 ， 保 持 简洁 可 测试 性 的 代码 和 好 的 实践 ， 我 想 我 
应 该 用 Kotlin 从 其 它 方面 去 简化 代码 。 如 果 你 想 了 解 一 些 控 制 反 转 或 者 依赖 注入 的 

话题 ， 你 可 以 查看 我 关于 Android 中 使 用 Dagger 注 入 的 一 系列 文章 。 第 一 篇 文章 有 
关于 他 们 这 个 团队 的 简单 描写 。 


一 种 简单 的 方式 ， 如 果 我 们 想 拥 有 一 些 独立 于 其 他 类 的 类 ， 这 样 更 容易 测试 ， 并 编 
写 代 码 ， 易 于 扩展 和 维护 ， 这 时 我 们 需要 使 用 依赖 注入 。 我 们 不 去 在 类 内 部 去 实例 
化 ， 我 们 在 其 它 地 方 提 供 它们 (通常 通过 构造 函数 ) 或 者 实例 化 它们 。 用 这 种 方 
式 ， 我 们 可 以 用 其 它 的 对 象 来 替代 他 们 。 比 如 可 以 实现 同样 的 接口 或 者 在 tests 中 使 
用 mocks。 


但 是 现在 ， 这 些 依赖 必须 要 在 某 些 地 方 被 提供 ， 所 以 依赖 注入 由 提供 合作 者 的 类 组 
成 。 这 些 通常 pene 注入 器 来 完成 。Dagger 可 能 是 Android 上 最 流行 的 依赖 注入 
器 。 当 然 当 我 们 提供 依赖 有 一 定 复杂 性 的 时 候 是 个 很 好 的 替代 品 。 


但 是 最 小 的 蔡 代 是 可 以 在 这 个 构造 函数 中 使 用 默认 值 。 我 们 可 以 给 构造 函数 的 参数 
通过 分 配 默认 值 的 方式 提供 一 个 依赖 ， 然 后 在 不 同 的 情况 下 提供 不 同 的 实例 。 比 
如 ， 在 我 们 的 ForecastDbHelper 我 们 可 以 用 更 智能 的 方式 提供 一 个 context : 


class ForecastDbHelper(ctx: Context = App.instance) : 
ManagedSQLiteOpenHelper(ctx, ForecastDbHelper.DB_NAME, n 
UA 
ForecastDbHelper .DB VERSION) { 


现在 我 们 有 两 种 方式 来 创建 这 个 类 : 


val dbHelper1 = ForecastDbHelper() // 它 会 使 用 App.instance 
val dbHelper2 = ForecastDbHelper(mockedContext) // 比如 ， 提 供给 测试 


tests 


我 会 到 处 使 用 这 个 特性 ， 所 以 我 在 解释 清楚 之 后 再 继续 往 下 。 我 们 已 经 有 了 表 ， 所 
以 是 时 候 开 始 对 它们 增加 和 请 求 了 。 但 是 在 这 之 前 ， 我 想 先 讲 讲 结合 和 六 数 操作 
符 。 别 忘 了 查看 代码 库 找到 最 新 的 代码 。 


集合 和 函数 操作 符 


在 我 们 这 个 项 目 我 们 已 经 使 用 过 集合 了 ， 但 是 现在 是 时 候 展示 它们 结合 函数 操作 符 
之 后 有 多 强大 了 。 关 于 函数 式 编程 很 不 错 的 一 点 是 我 们 不 用 去 解释 我 们 怎么 去 做 ， 
而 是 直接 说 我 想 做 什么 。 比 如 ， 如 果 我 想 去 过 滤 一 个 list， 不 用 去 创建 一 个 list， 遍 

历 这 个 list 的 每 一 项 ， 然 后 如 果 满 足 一 定 的 条 件 则 放 到 一 个 新 的 集合 中 ， 而 是 直接 食 
用 filer 亟 数 并 指明 我 想 用 的 过 滤器 。 用 这 种 方式 ， 我 们 可 以 节省 大 量 的 代码 。 


虽然 我 们 可 以 直接 用 Java 中 的 集合 ， 但 是 Kotlin 也 提供 了 一 些 你 希望 用 的 本 地 的 接 


Q: 


e lterable : 父 类 。 所 有 我 们 可 以 遍历 一 系列 的 都 是 实现 这 个 接口 。 

e Mutablelterable : 一 个 支持 遍历 的 同时 可 以 执行 删除 的 lterables 。 

e Collection: 这 个 类 相 是 一 个 范 性 集合 。 我 们 通过 函数 访问 可 以 返回 集合 的 
Size、 是 否 为 宣 、 是 否 包含 一 个 或 者 一 些 item。 这 个 集合 的 所 有 方法 提供 查 
询 ， 因 为 connections 是 不 可 修改 的 。 

e MutableCollection : 一 个 支持 增加 和 删除 item 的 Collection。 它 提供 了 额外 的 
函数 ， 比 如 add ` remove ` clear 等 等 。 

e List: 可 能 是 最 流行 的 集合 类 型 。 它 是 一 个 范 性 有 序 的 集合 。 因 为 它 的 有 序 
我 们 可 以 使 用 get 元 数 通 过 position 来 访问 。 

e MutableList : 一 个 支持 增加 和 删除 item 的 List 。 

e Set: 一 个 无 序 并 不 支持 重复 item 的 集合 。 

e MutableSet : 一 个 支持 增加 和 删除 item 的 Set 。 

e Map : 一 个 key-value 对 的 collection。key 在 map 中 是 唯一 的 ， 也 就 是 说 不 能 
两 对 key 是 一 样 的 键 值 对 存在 于 一 个 map 中 。 

e MutableMap : 一 个 支持 增加 和 删除 item 的 map。 


有 很 多 不 同 集合 可 用 的 函数 操作 符 。 我 想 通 过 一 个 例子 来 展示 给 你 看 。 知 道 有 哪些 
可 选 的 操作 符 是 很 有 用 的 ， 因 为 这 样 会 更 容易 分 辨 它们 使 用 的 时 机 。 


4 Æ Le 大 大 

总 数 操 作 符 

any 

如 果 至 少 有 一 个 元 素 符 合 给 出 的 判断 条 件 ， 则 返回 true。 
VTS 


assertTrue(list.any { it % 2 == 0 }) 
assertFalse(list.any { it > 10 }) 


all 
如 果 全 部 的 元 素 符合 给 出 的 判断 条 件 ， 则 返回 true 。 


assertTrue(list.all { it < 10 }) 
assertFalse(list.all { it % 2 == 0 }) 


count 

返回 符合 给 出 判断 条 件 的 元 素 总 数 。 
assertEquals(3, list.count { it % 2 == 0 }) 

fold 

在 一 个 初始 值 的 基础 上 从 第 一 项 到 最 后 一 项 通过 一 个 函数 累计 所 有 的 元 素 。 
assertEquals(25, list.fold(4) { total, next -> total + next }) 


foldRight 


与 fold 一 样 ， 但 是 顺序 是 从 最 后 一 项 到 第 一 项 。 


assertEquals(25, list.foldRight(4) { total, next -> total + next 
}) 


forEach 


遍历 所 有 元 素 ， 并 执行 给 定 的 操作 。 


list.forEach { printlin(it) } 


forEachIndexed 


与 foreach ， 但 是 我 们 同时 可 以 得 到 元 素 的 index ° 


list.forEachIndexed { index, value 
-> println("position $index contains a $value") } 


max 

返回 最 大 的 一 项 ， 如 果 没 有 则 返回 null 。 
assertEquals(6, list.max()) 

maxBy 

根据 给 定 的 函数 返回 最 大 的 一 项 ， 如 果 没 有 则 返回 null。 


// The element whose negative is greater 


assertEquals(1, list.maxBy { -it }) 


min 
返回 最 小 的 一 项 ， 如 果 没 有 则 返回 null。 


assertEquals(i, list.min()) 


minBy 


根据 给 定 的 函数 返回 最 小 的 一 项 ， 如 果 没 有 则 返回 null。 


The element whose negative is smaller 


assertEquals(6, list.minBy { -it }) 


none 
果 没 有 任何 元 素 与 给 函数 匹配 ， 则 返回 true。 
‘/ No elements are divisible by 7 
assertTrue(list.none { it % 7 == 0 }) 
reduce 
5 fold 一 样 ， 但 是 没有 一 个 初始 值 。 通 过 一 个 函数 从 第 一 项 到 最 后 一 项 进行 累 
TH ° 


assertEquals(21, list.reduce { total, next -> total + next }) 
reduceRight 
与 reduce 一 样 ， 但 是 顺序 是 从 最 后 一 项 到 第 一 项 。 


assertEquals(21, list.reduceRight { total, next -> total + next 


}) 


sumBy 


返回 所 有 每 一 项 通过 函数 转换 之 后 的 数据 的 总 和 。 


assertEquals(3, list.sumBy { it % 2 }) 


总 数 操作 符 
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过 滤 操作 符 


drop 


返回 包含 去 掉 前 n 个 元 素 的 所 有 元 素 的 列表 。 
assertEquals(listOf(5, 6), list.drop(4)) 
dropWhile 
返回 根据 给 定 函 数 从 第 一 项 开始 去 掉 指 定 元 素 的 列表 。 
assertEquals(listOf(3, 4, 5, 6), list.dropwhile { it < 3 }) 
dropLastWhile 
返回 根据 给 定 函 数 从 最 后 一 项 开始 去 掉 指 定 元 素 的 列表 。 
assertEquals(listOf(i, 2, 3, 4), list.dropLastWhile { it > 4 }) 
filter 
过 滤 所 有 符合 给 定 函 数 条 件 的 元 素 。 
assertEquals(listOf(2, 4, 6), list.filter { it % 2 == 0 }) 
filterNot 
过 滤 所 有 不 符合 给 定 函 数 条 件 的 元 素 。 


assertEquals(listoOf(i, 3, 5), list.filterNot { it % 2 == 0 }) 


filterNotNull 


过 滤 所 有 元 素 中 不 是 null 的 元 素 。 


assertEquals(listOf(i, 2, 3, 4), listWithNull.filterNotNull()) 


slice 


过 滤 一 个 list 中 指定 index 的 元 素 。 


assertEquals(listOf(2, 4, 5), list.slice(listOf(i, 3, 4))) 


take 


返回 从 第 一 个 开始 的 n 个 元 素 。 


assertEquals(listOf(i, 2), list.take(2)) 


takeLast 


返回 从 最 后 一 个 开始 的 n 个 元 素 


assertEquals(listOf(5, 6), list.takeLast(2)) 


takeWhile 


返回 从 第 一 个 开始 符合 给 定 函 数 条 件 的 元 素 。 


assertEquals(listoOf(i, 2), list.takeWhile { it < 3 }) 


映射 操作 符 


flatMap 

遍历 所 有 的 元 素 ， 为 每 一 个 创建 一 个 集合 ， 最 后 把 所 有 的 集合 放 在 一 个 集合 中 。 
assenLequals(istoi(d, 2. 2, 3, 3, 4,4, 5, 5,56, 6, 7), 
list.flatMap { listof(it, it + 1) }) 

groupBy 


返回 一 个 根据 给 定 函 数 分 组 后 的 map。 


assertEquals(mapOf("odd" to listof(1, 3, 5), "even" to listOf(2, 
4, 6)), list.groupBy { if (it % 2 == 0) "even" else "odd" }) 


EC > —————>—————X£&£E£=—— es | 
map 


返回 一 个 每 一 个 元 素 根据 给 定 的 函数 转换 所 组 成 的 List © 
assertEquals(listOf(2, 4, 6, 8, 10, 12), list.map { it * 2 }) 

mapIndexed 

返回 一 个 每 一 个 元 素 根据 给 定 的 包含 元 素 index 的 函数 转换 所 组 成 的 List 。 


assertEquals(listoOf (0, 2, 6, 12, 20, 30), list.mapIndexed { ind 
ex, it -> index * it }) 


mapNotNull 


返回 一 个 每 一 个 非 null 元 素 根据 给 定 的 函数 转换 所 组 成 的 List。 


assertEquals(listOf(2, 4, 6, 8), listWithNull.mapNotNull { it * 2 
}) 


加 二 时 
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contains 


如 果 指 定 元 素 可 以 在 集合 中 找到 ， 则 返回 true。 
assertTrue(list.contains(2)) 


elementAt 


返回 给 定 index 对 应 的 元 素 ， 如 果 index 数 组 越界 则 会 抛 
出 IndexOutOfBoundsException 。 


assertEquals(2, list.elementAt(1)) 


elementAtOrElse 

返回 给 定 jindex 对 应 的 元 素 ， 如 果 index 数 组 越界 则 会 根据 给 定 函 数 返 回 默认 值 。 
assertEquals(20, list.elementAtOrElse(10, { 2 * it })) 

elementAtOrNull 

返回 给 定 index 对 应 的 元 素 ， 如 果 index 数 组 越界 则 会 返回 null 。 


assertNull(list.elementAtOrNull(10)) 


返回 符合 给 定 函 数 条 件 的 第 一 个 元 素 。 


assertEquals(2, list.first { it % 2 == 0 }) 


firstOrNull 


返回 符合 给 定 函 数 条 件 的 第 一 个 元 素 ， 如 果 没 有 符合 则 返回 null 。 


assertNull(list.firstOrNull { it % 7 == 0 }) 


indexOf 


返回 指定 元 素 的 第 一 个 index， 如 果 不 存 在 ， 则 返回 -1 ° 


assertEquals(3, list.indexOf(4)) 


indexOfFirst 


回 第 一 个 符合 给 定 函 数 条 件 的 元 素 的 index， 如 果 没 有 符合 则 返回 -1 © 


assertEquals(i, list.indexOfFirst { it % 2 == 0 }) 


indexOfLast 


返回 最 后 一 个 符合 给 定 函 数 条 件 的 元 素 的 index， 如 果 没 有 符合 则 返回 -1 © 


assertEquals(5, list.indexOfLast { it % 2 == 0 }) 


返回 符合 给 定 函 数 条 件 的 最 后 一 个 元 素 。 


assertEquals(6, list.last { it % 2 == 0 }) 


lastindexOf 


返回 指定 元 素 的 最 后 一 个 index， 如 果 不 存在 ， 则 返回 -1 © 


lastOrNull 


返回 符合 给 条 件 的 最 后 一 个 元 素 ， 如 果 没 有 符合 则 返回 null。 


val last = listof(1, 2, 2, 4, 5; 6) 
assertNull(list.lastOrNull { it % 7 == 0 }) 


single 

返回 符合 给 定 函 数 的 单个 元 素 ， 如 果 没 有 符合 或 者 超过 一 个 ， 则 抛 出 异常 。 
assertEquals(5, list.single { it % 5 == 0 }) 

singleOrNull 

返回 符合 给 定 函 数 的 单个 元 素 ， 如 果 没 有 符合 或 者 超过 一 个 ， 则 返回 null。 


assertNull(list.singleOrNull { it % 7 == 0 }) 


生产 操作 符 


merge 


把 两 个 集合 合并 成 一 个 新 的 ， 相 同 index 的 元 素 通过 给 定 的 函数 进行 合并 成 新 的 元 素 
作为 新 的 集合 的 一 个 元 素 ， 返 回 这 个 新 的 集合 。 新 的 集合 的 大 小 由 最 小 的 那个 集合 
大 小 决定 。 


Val dist = Istor 27 67.4445, 6) 

val listRepeated = listOf(2, 2, 3, 4, 5, 5, 6) 
assertEquals(listOf(3, 4, 6, 8, 10, 11), list.merge(listRepeated 
) { it1, it2 -> it1 + it2 }) 


partition 


把 一 个 给 定 的 集合 分 割 成 两 个 ， 第 一 个 集合 是 由 原 集 合 每 一 项 元 素 匹 配给 定 函 数 条 
件 返 回 true 的 元 素 组 成 ， 第 二 个 集合 是 由 原 集合 每 一 项 元 素 匹 配给 定 函 数 条 件 返 
回 false 的 元 素 组 成 。 


assertEquals( 
Pair(listof(2, 4, 6), listor(, 3, 5)), 
list.partition { it % 2 == 0 } 


plus 
返回 一 个 包含 原 集合 和 给 定 集合 中 所 有 元 素 的 集合 ， 因 为 函数 的 名 字 原 因 ， 我 们 可 
以 使 用 + 操作 符 。 


assertEquals( 
iis Ot i2 S urd 5 Gen 9 
list + listOf(7, 8) 


zip 


返回 由 pair 组 成 的 List， 每 个 pair 由 两 个 集合 中 相同 index 的 元 素 组 成 。 这 个 返 
回 的 List 的 大 小 由 最 小 的 那个 集合 决定 。 


assertEquals( 
listOf(Pair(1, 7), Pair(2, 8)), 
list.zip(listOf(7, 8)) 


unzip 
从 包含 pair 的 List 中 生成 包含 List 的 Pair。 
assertEquals( 


Pair(listof(5, 6), listOf(7, 8)), 
listOf(Pair(5, 7), Pair(6, 8)).unzip() 


MBL FR AVE FF 


reverse 


返回 一 个 与 指定 list 相 反 顺 序 的 list e 


val unsortedList = listOf(3, 2, 7, 5) 


assertEquals(listOf(5, 7, 2, 3), 
sort 
返回 一 个 自然 排序 后 的 list。 
assertEquals(listoOf(2, 3, 5, 7), 
sortBy 
返回 一 个 根据 指定 函数 排序 后 的 list。 
assertEquals(listOf(3, 7, 2, 5), 
sortDescending 
返回 一 个 降序 排序 后 的 List 。 
assertEquals(listOf(7, 5, 3, 2), 
sortDescendingBy 
返回 一 个 根据 指定 函数 降序 排序 后 的 list 。 


assertEquals(listOf(2, 5, 7, 3), 
it % 3 }) 


unsortedList. 


unsortedList. 


unsortedList. 


unsortedList. 


unsortedList. 


reverse()) 


sort()) 


sortBy { it % 3 }) 


sortDescending() ) 


sortDescendingBy { 


顺序 操作 符 
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从 数据 库 中 保存 或 查询 数据 


前 面 一 个 章节 中 我 们 讲 了 关于 SQLiteOpenHelper 的 创建 ， 但 是 我 们 需要 在 必要 
的 时 候 有 方法 去 保存 我 们 的 数据 到 数据 库 ， 或 者 从 我 们 的 数据 库 中 查询 数据 。 另 外 
一 个 叫 ForecastDb 类 就 会 做 这 件 事 。 


创建 数据 库 model 类 


但 是 首先 ， 我 们 要 去 为 数据 库 创 建 model 类 。 你 还 记得 我 们 之 前 所 见 的 map 委 托 的 
方式 ? 我 们 要 把 这 些 属性 直接 映射 到 数据 库 中 ， 反 过 来 也 一 样 。 


我 们 先 来 看 下 CityForecast 类 : 


class CityForecast(val map: MutableMap<String, Any?>, 
val dailyForecast: List<DayForecast>) 


var _id: Long by map 
var city: String by map 
var country: String by map 


constructor(id: Long, city: String, country: String, 
dailyForecast: List<DayForecast>) 
: this(HashMap(), dailyForecast) { 
this, id = id 
this.city = city 
this.country = country 


默认 的 构造 函数 会 得 到 一 个 含有 属性 和 对 应 的 值 的 map， 和 一 个 dailyForecast。 多 
亏 了 委托 ， 这 些 值 会 根据 key 的 名 字 会 映射 到 相应 的 属性 中 去 。 如 果 我 们 硕 望 映射 
的 过 程 运 行 完美 ， 那 么 属性 的 名 字 必 须要 和 数据 库 中 对 应 的 名 字 一 模 一 样 。 我 们 后 
面 会 讲 原 因 。 


但 是 ， 第 二 个 构造 函数 也 是 必要 的 。 这 是 因为 我 们 需要 从 domain 映 射 到 数据 库 类 
中 ， 所 以 不 能 使 用 map， 从 属性 中 设置 值 也 是 方便 的 。 我 们 传 入 一 个 空 的 map， 但 
是 又 一 次 ， 多 亏 了 委托 ， 当 我 们 设置 值 到 属性 的 时 候 ， 它 会 自动 增加 所 有 的 值 到 
map 中 。 用 这 种 方式 ， 我 们 就 准备 好 map 来 保存 到 数据 库 中 了 。 使 用 了 这 些 有 用 的 
代码 ， 我 将 会 看 见 它 运行 起 来 就 像 魔法 一 样 神奇 。 


现在 我 们 需要 第 二 个 类 ，DayForecast， 它 会 是 第 二 个 表 。 它 包括 表 中 的 每 一 列 作 
为 它 的 属性 ， 它 也 有 第 二 个 构造 函数 。 唯 一 不 同 之 处 就 是 不 需要 设置 id， 因 为 它 将 
通过 SQLite 自 增长 。 


class DayForecast(var map: MutableMap<String, Any?>) { 
var _id: Long by map 
var date: Long by map 
var description: String by map 
var high: Int by map 
var low: Int by map 
var iconUrl: String by map 
var cityId: Long by map 


constructor(date: Long, description: String, high: Int, low: 
Int, 
iconUrl: String, cityId: Long) 
: this(HashMap()) { 
this.date = date 
this.description = description 
this.high = high 
this.low = low 
this.iconUrl = iconuUrl 
this.cityId = citylId 


aaa ee ee 
这 些 类 将 会 帮助 我 们 SQLite 表 与 对 象 之 间 的 互相 映射 。 


写 入 和 查询 数据 库 


SqliteOpenHelper 只 是 一 个 工具 ， 是 SQL 世界 和 OOP 之 间 的 一 个 通道 。 我 们 要 
新 建 几 个 类 来 请 求 已 经 保存 在 数据 库 中 的 数据 ， 和 保存 新 的 数据 。 被 定义 的 类 会 使 
用 ForecastDbHelper 和 DataMapper 来 转换 数据 库 中 的 数据 到 domain 
models 。 我 仍 日 使 用 默认 值 的 方式 来 实现 简单 的 依赖 注入 : 


class ForecastDb( 

val forecastDbHelper: ForecastDbHelper = ForecastDbHelper.in 
stance, 

val dataMapper: DbDataMapper = DbDataMapper()) { 


所 有 的 函数 使 用 前 面 章节 讲 到 过 的 use() 函数 。lambda 返 回 的 值 也 会 被 作为 这 个 
函数 的 返回 值 。 所 以 让 我 们 定义 一 个 使 用 zip code 和 date 来 查询 一 


个 forecast 的 函数 : 


fun requestForecastByZipCode(zipCode: Long, date: Long) = foreca 
stDbHelper.use { 


这 么 没有 什么 解释 的 : 我 们 使 用 use 函数 返回 的 结果 作为 这 个 函数 返回 的 结果 。 


查询 一 个 forecast 

第 一 个 要 做 的 查询 就 是 每 日 的 天 气 预 报 ， 因 为 我 们 需要 这 个 列表 来 创建 一 

个 city 对 象 。Anko 提 供 了 一 个 简单 的 请 求 构建 器 ， 所 以 我 们 来 利用 下 这 个 有 利 
条 件 : 


val dailyRequest = "${DayForecastTable.CITY_ID} =? " + 
"AND ${DayForecastTable.DATE} >= ?" 


val dailyForecast = select(DayForecastTable.NAME) 
.whereSimple(dailyRequest, zipCode.toString(), date.toSt 


ring()) 
.parseList { DayForecast(HashMap(it)) } 


第 一 行 ， Sealant 是 查询 语 名 中 where 的 一 部 分 。 它 是 whereSimple & 
数 需要 的 第 一 个 参数 ， 这 与 我 们 用 一 般 的 helper 做 的 方式 很 相似 。 这 里 有 另外 一 个 
简化 的 where 函数 ， 它 需要 一 些 tags 和 values 来 进行 匹配 。 我 不 太 喜 欢 这 个 方 
式 ， 因 为 我 觉得 这 个 增加 了 代码 的 模版 化 ， 虽 然 这 个 对 我 们 把 values 解 析 成 String 
很 有 利 。 最 后 它 看 起 来 会 是 这 样 : 


val dailyRequest = "${DayForecastTable.CITY_ID} = {id}" + "AND $ 
{DayForecastTable.DATE} >= {date}" 


val dailyForecast = select(DayForecastTable.NAME) 
.where(dailyRequest, "id" to zipCode, "date" to date) 
.parseList { DayForecast(HashMap(it)) } 


你 可 以 选择 你 喜欢 的 一 种 方式 。 select 函数 是 很 简单 的 ， 它 仅仅 是 需要 一 个 被 查 
询 表 的 名 字 。 parse 函数 的 时 候 会 有 一 些 魔法 在 里 面 。 在 这 个 例子 中 我 们 假设 请 
求 结果 是 一 个 list， 使 用 了 parseList BR Cle A 

了 RowParser 或 RapRowParser 函数 去 把 cursor 转 换 成 一 个 对 象 的 集合 。 这 两 个 
不 同 之 处 就 是 RowParser 是 依赖 列 的 顺序 的 ， 而 MapRowParser 是 从 map 中 拿 到 
作为 column 的 key 名 的 。 


在 它们 之 间 有 两 个 重 载 的 冲突 ， 所 以 我 们 不 能 直接 使 用 简化 的 方式 准确 地 创建 需要 
的 对 象 。 但 是 没有 什么 是 不 能 通过 扩展 函数 来 解决 的 。 我 创建 了 一 个 接收 一 个 
lambda A 232 E— 7+ MapRowParser 的 元 数 。 解 析 器 会 调用 这 个 lambda 来 创建 

个 对 象 : 


fun <T : Any> SelectQueryBuilder.parseList( 
parser: (Map<String, Any>) -> T): List<T> = 
parseList(object : MapRowParser<T> { 
override fun parseRow(columns: Map<String, Any>): T 
= parser(columns) 


}) 
这 个 函数 可 以 帮助 我 们 简单 地 去 parseList 查询 的 结果 : 


parseList { DayForecast(HashMap(it)) } 


解析 器 接收 的 immutable map 被 我 们 转化 成 了 一 个 mutable map (我 们 需要 
在 database model 中 是 可 以 修改 的 ) 通过 使 用 相应 的 HashMap 构造 函数 。 
在 DayForecast 中 的 构造 函数 中 会 使 用 到 这 个 HashMap ° 


所 以 ， 这 个 查询 返回 了 一 个 Cursor ， 要 理解 这 个 场景 的 背后 到 底 发 生 了 什 

Ao parseList 中 会 迭代 它 ， 然 后 得 到 cursor 的 每 一 行 直到 最 后 一 个 。 对 于 每 
一 行 ， 它 会 创建 一 个 包含 这 列 的 key 和 给 对 应 的 key 赋 值 后 的 map。 然 后 把 这 个 map 
返回 给 这 个 解析 器 。 


如 果 查 询 没 有 任何 结果 ， parseList 会 返回 一 个 空 的 list 。 


下 一 步 查询 城市 也 是 一 样 的 方法 : 


val city = select(CityForecastTable. NAME) 
.whereSimple("${CityForecastTable.ID} = ?", zipCode.toSt 


ring()) 
.parseOpt { CityForecast(HashMap(it), dailyForecast) } 


不 同 之 处 是 : 我 们 使 用 的 是 parse0pt 。 这 个 函数 返回 一 个 可 null 的 对 象 。 结 果 可 
以 使 一 个 null 或 者 单个 的 对 象 ， 这 取决 于 请 求 是 否 能 在 数据 库 中 查询 到 数据 。 这 里 
有 另外 一 个 叫 parseSingle 的 函数 ， 本 质 上 是 一 样 的 ， 但 是 它 返 回 的 事 一 个 不 可 
null 的 对 象 。 所 以 如 果 没 有 在 数据 库 中 找到 这 一 条 数据 ， 它 会 抛 出 一 个 异常 。 在 我 
们 的 例子 中 ， 第 一 次 查询 一 个 城市 的 时 候 ， 肯 定 是 不 存在 的 ， 所 以 使 

用 parseOpt 会 更 安全 。 我 又 创建 了 一 个 好 用 的 函数 来 阻止 我 们 需要 的 对 象 的 创 

建 : 


public fun <T : Any> SelectQueryBuilder.parseOpt( 
parser: (Map<String, Any>) -> T): T? = 
parseOpt(object : MapRowParser<T> { 
override fun parseRow(columns: Map<String, Any>): T 
= parser(columns) 


}) 


最 后 如 果 返 回 的 city 不 是 null， 我 们 使 用 dataMapper 把 它 转换 成 domain 
object 再 返回 它 。 和 否则 ， 我 们 直接 返回 null。 你 应 该 记得 ，lambda 的 最 后 一 行 表 
示 返 回 值 。 所 以 这 里 将 会 返回 一 个 CityForecast? 类 型 的 对 象 : 


if (city != null) dataMapper.convertToDomain(city) else null 


DataMapper 函数 很 简单 : 


fun convertToDomain(forecast: CityForecast) = with(forecast) { 
val daily = dailyForecast.map { convertDayToDomain(it) } 
ForecastList(_id, city, country, daily) 


private fun convertDayToDomain(dayForecast: DayForecast) = with( 
dayForecast) { 
Forecast(date, description, high, low, iconUrl) 


fun requestForecastByZipCode(zipCode: Long, date: Long) = foreca 
stDbHelper.use { 


val dailyRequest = "${DayForecastTable.CITY_ID} = ? AND " + 
"${DayForecastTable.DATE} >= ?" 
val dailyForecast = select(DayForecastTable.NAME) 
.whereSimple(dailyRequest, zipCode.toString(), date. 
toString()) 
.parseList { DayForecast(HashMap(it)) } 


val city = select(CityForecastTable.NAME) 
.whereSimple("${CityForecastTable.ID} = ?", zipCode. 
toString()) 
.parseOpt { CityForecast(HashMap(it), dailyForecast) 


if (city != null) dataMapper.convertToDomain(city) else null 


另外 一 个 Anko 中 好 玩 的 功能 我 们 在 这 里 展示 ， 那 就 是 你 可 以 使 

用 classParser() 来 替代 我 们 用 的 MapRowParser ， 它 是 基于 列 名 marly 
方式 去 生成 对 象 的 。 我 喜欢 另 一 种 方法 因为 我 不 需要 使 用 反射 并 且 还 we 进行 

转换 操作 ， 但 是 在 有 时 候 可 能 对 你 有 用 。 


保存 一 个 forecast 


saveForecast 函数 只 是 从 数据 库 中 清除 数据 ， 然 后 转换 domain mode| 为 数据 
库 model， 然 后 插入 每 一 天 的 forecast 和 city forecast 。 这 个 结构 比 之 前 的 
更 简单 : 它 通过 use BRAM database helper 中 返回 数据 。 在 这 个 例子 中 我 们 
不 需要 返回 值 ， 所 以 它 将 返回 unit ° 


fun saveForecast(forecast: ForecastList) = forecastDbHelper.use { 





首先 ， 我 们 清空 这 两 个 表 。Anko 没 有 提供 比较 漂亮 的 方式 来 做 这 个 ， 但 这 并 不 意 ” 
着 我 们 不 行 。 所 以 我 们 创建 了 一 个 SQLiteDatabase 的 扩展 函数 来 让 我 们 可 以 像 
SQL 查询 一 样 来 执行 它 : 


fun SQLiteDatabase.clear(tableName: String) { 
execSQL("delete from $tableName" ) 


清空 这 两 个 表 : 


clear (CityForecastTable. NAME ) 
clear (DayForecastTable.NAME) 


现在 ， 是 时 候 去 转换 执行 insert 后 返回 的 数据 了 。 在 这 一 点 上 你 可 能 直到 我 
是 with 函数 的 粉丝 : 


with(dataMapper.convertFromDomain(forecast)) { 


JA domain model 转换 的 方式 也 是 很 直接 的 : 


fun convertFromDomain(forecast: ForecastList) = with(forecast) { 
val daily = dailyForecast.map { convertDayFromDomain(id, it) 


CityForecast(id, city, country, daily) 


private fun convertDayFromDomain(cityId: Long, forecast: Forecast 


with(forecast) { 
DayForecast(date, description, high, low, iconUrl, cityI 





在 代码 块 ， 我 们 可 以 在 不 使 用 引用 和 变量 的 情况 下 使 

用 dailyForecast 和 map ， 只 是 像 我 们 在 这 个 类 内 部 一 样 就 可 以 了 。 针 对 插入 
我 们 使 用 另外 一 个 Anko 郊 数 ， Caw vararg 修饰 

的 Pair<String, Any> 作为 参数 。 这 个 函数 会 把 vararg 转换 成 Android SDK 需 
要 的 ContentValues 对 象 。 P on map 转换 成 一 

个 vararg 数组 。 我 们 为 MutableMap 创建 了 一 个 扩展 函数 : 


fun <K, V : Any> MutableMap<K, V?>.toVarargArray(): 
Array<out Pair<K, V>> = map({ Pair(it.key, it.value!!) }).t 
oTypedArray( ) 


它 是 支持 可 null 的 值 的 (这 是 map delegate NAH) ， 把 它 转换 为 非 null 值 
select 函数 需要 ) 的 Array 所 组 成 的 Pairs 。 不 用 担心 就 算 你 不 完全 理解 
这 


( 
这 个 函数 ， 我 很 快 就 会 讲 到 可 空 性 。 
所 以 ， 这 个 新 的 函数 我 们 可 以 这 么 使 用 : 


insert(CityForecastTable.NAME, *map.toVarargArray()) 


它 在 CityForecast A 。 在 EO OA TY 函数 结果 
前 面 使 用 * 表示 这 个 array 会 被 分 解 成 为 一 个 vararg 参数 。 这 个 在 Java 中 是 自动 
处 理 的， 但 是 我 们 nn 明确 指明 。 


每 天 的 天 气 预 报 也 是 一 样 了 : 


dailyForecast.forEach { insert(DayForecastTable.NAME, *it.map.to 
VarargArray()) } 


所 以 ， 通 过 map 的 使 用 ， AAA > 反之 亦 
然 。 因 为 我 们 已 经 新 建 了 扩展 函数 ， 我 们 可 以 在 别 的 项 目 中 使 用 ， 这 个 才 是 丨 正 可 
贵 的 地 方 。 


这 个 函数 的 完整 代码 如 下 


fun saveForecast(forecast: ForecastList) = forecastDbHelper.use { 


clear (CityForecastTable. NAME ) 
clear (DayForecastTable.NAME) 


with(dataMapper.convertFromDomain(forecast)) { 
insert(CityForecastTable.NAME, *map.toVarargArray()) 
dailyForecast forEach { 
insert(DayForecastTable.NAME, *it.map.toVarargArray( 


)) 


在 这 一 章 中 有 很 多 代码 被 需要 ， 所 以 你 可 以 到 代码 库 中 查看 检 出 。 


Kotlin 中 的 null 安 全 


如 果 你 正在 使 用 Java 7 工作 的 话 ，null 安 全 是 Kotlin 中 最 令 人 感 兴趣 的 特性 之 一 了 。 
但 是 就 如 你 在 本 书 中 看 到 的 ， 它 好 像 不 存在 一 样 ， 一 直到 上 一 章 我 们 几乎 都 不 需要 
去 担心 它 。 


通过 我 们 自己 创造 的 亿 万 美金 的 错误 对 null 的 思考 ， 我 们 有 时 候 的 确 需 要 去 定义 一 
个 变量 包 不 包含 一 个 值 。 在 Java 中 尽管 注解 和 |DE 在 这 方面 帮 了 我 们 很 多 ， 但 是 我 
们 仍然 可 以 这 么 做 : 


Forecast forecast = null; 
forecast.toString(); 


a aie cael 〈 你 可 能 会 从 IDE 上 得 到 一 个 警告 ) ， 然 后 正常 地 执 
ae 显然 它 会 抛 一 个 NullPointerException 。 这 个 相当 不 安全 的 。 而 且 按 
pg 我 们 应 该 去 控制 一 切 ， 随 着 代码 的 增长 ， 我 们 会 慢 慢 对 某 些 nul| 的 
控制 。 所 以 最 终 会 得 到 很 多 的 NullPointerException 或 者 丢失 很 多 null 检 查 (可 


能 两 者 混合 ) 。 


~ 


可 null 类 型 怎么 工作 


大 部 分 现代 语言 使 用 某 些 方法 去 解决 了 这 个 问题 ，Kotlin 的 方法 跟 别 的 相似 的 语言 

比 是 相当 另类 和 不 同 的 。 但 是 黄金 准则 还 是 一 样 : 如 果 变 量 是 可 以 是 null， 编 译 器 

强制 我 们 去 用 某 种 方式 去 处 理 。 

指定 一 个 变量 是 可 null 是 通过 在 类 型 的 最 后 增加 一 个 问号 。 因 为 在 Kotlin 中 一 切 都 是 
对 象 〈 甚 至 是 Java 中 原始 数据 类 型 ) ， 一 切 都 是 可 null 的 。 所 以 ， 当 然 我 们 可 以 有 

一 个 可 null 的 integer : 


valla: Tne? = muih 


一 个 可 nul 类 型 ， 你 在 没有 进行 检查 之 前 你 是 不 能 直接 使 用 它 。 这 个 代码 不 能 被 编 
译 : 


val as Int? = null 
a.toString() 


前 一 行 代码 标记 为 可 null， 然 后 编译 器 就 会 知道 它 ， 所 以 在 你 null 检 查 之 前 你 不 能 
使 用 它 。 还 有 一 个 特性 是 当 我 们 检查 了 一 个 对 象 的 可 null 性 ， 之 后 这 个 对 象 就 会 自 
动 转型 成 不 可 null 类 型 ， 这 就 是 Kotlin 编 译 器 的 智能 转换 : 


vala:Int?=null 


if(a!=null){ 
a.toString() 


在 if P> a 从 Int? RAT Int ， 所 以 我 们 可 以 不 需要 再 检查 可 null 性 而 直接 
使 用 它 。 if 代码 之 外 ， 当 然 我 们 又 得 检查 处 理 。 这 仅仅 在 变量 当前 不 能 被 改变 的 
时 候 才 有 效 ， 因 为 否则 这 个 value 可 能 被 另外 的 线程 修改 ， 这 时 前 面 的 检查 会 返回 
falsec val 属性 或 者 本 地 ( val or var ) 变量 。 


这 听 起 来 会 让 事情 变 得 更 多 。 难 道 我 们 不 得 不 去 编写 大 量 代码 去 进行 可 null 性 的 检 
查 ? 当然 不 是 ， i“? 因为 大 多 数 时 候 你 不 需要 使 用 null 类 型 。Null 引 用 没有 我 们 想 
象 中 的 有 用 ， 当 你 想 弄 清楚 一 个 变量 是 否 可 以 为 null 时 你 就 会 发 现 这 一 点 。 但 是 
Kotlin 也 有 它 自己 的 使 处 理 更 简洁 的 方案 。 举 个 例子 ， 我 们 如 下 简化 代码 : 


val a: Int? = null 

a?.toString() 
这 里 我 们 使 用 了 安全 访问 操作 符 ( ? )。 只 有 这 个 变量 不 是 null 的 时 候 才 会 去 执行 前 
面 的 那 行 代 码 。 否 则 ， 它 不 会 做 任何 事情 。 并 且 我 们 甚至 可 以 使 用 Elvis 


operator( ?: ) : 


val a:Int? = null 
val myString = a?.toString() ?3: "" 


因为 在 Kotlin 中 throw 和 return 都 是 表达 式 ， 他 们 可 以 用 在 Elvis operator 操 作 
符 的 右边 : 


val myString = a?.toString() ?: return false 


val myString = a?.toString() ?: throw IllegalStateException() 


然后 ， 我 们 可 能 会 遇 到 这 种 情景 ， 我 们 确定 我 们 是 在 用 一 个 非 null 变 量 ， 但 是 他 的 
类 型 却 是 可 null 的 。 我 们 可 以 使 用 !11 操作 符 来 强制 编译 器 执行 可 null 类 型 时 跳 过 限 
制 检查 : 


val a: Int? = null 
a!!.toString() 


上 面 的 代码 将 会 被 编译 ， 但 是 很 显然 会 奔 溃 。 所 以 我 们 要 确保 只 能 在 特定 的 情况 下 
使 用 。 通 常 我 们 可 以 自己 选择 作为 解决 方案 。 如 果 一 份 代码 满 篇 都 是 1!! > ABA 
股 代码 没有 被 正确 处 理 的 气味 了 。 


可 null 类 型 怎么 工作 
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可 null 性 和 Java 库 


好 了 ， 前 面 的 章节 解释 了 使 用 Kotlin 代 码 完 美 地 工作 。 但 是 与 普通 的 Java 库 和 
Android SDK 会 发 生 什 么 呢 ? 在 Java 中 ， 所 有 对 象 可 以 被 定义 为 null。 所 以 我 们 不 
得 不 处 理 大 量 潜在 的 在 现实 中 不 可 能 是 null 的 null 变 量 。 这 意味 着 我 们 的 代码 最 后 可 
能 会 有 几 百 个 11 操作 符 ， 这 绝对 不 是 一 个 好 的 主意 。 


当 我 们 去 处 理 Android SDK 时 ， 你 可 能 看 见 所 有 Java 方 法 的 参数 被 标记 为 单个 
的 1 。 比 如 ，Java 中 在 一 些 获 取 对 象 的 方法 在 Kotlin 中 显示 返回 Any! 。 这 表示 
让 开发 者 自己 决定 是 否 这 个 变量 是 否 可 null © 


很 幸运 ， 新 版 本 的 Android 开 始 使 用 @Nullable 和 @NonNull 注解 来 辨别 参数 是 
否 可 以 是 null 或 者 否 个 函数 是 否 可 以 返回 null。 当 我 们 怀疑 时 ， 我 们 可 以 进入 源码 去 
会 查 是 否 会 接收 到 一 个 hull 对象。 我 的 猜想 是 在 以 后 ， 编 译 器 能 够 读 取 这 些 注解 
然后 强制 (或 者 至 少 是 建议 ) 一 个 更 好 的 方法 。 


现在 开始 ， 当 一 个 Jetbrains 的 @Nullable 注解 (这 个 与 Android 的 注解 不 同 ) 被 注 
解 在 一 个 非 null 的 变量 时 ， 就 会 获得 一 个 警告 9 相对 的 没有 发 生 在 @NotNull 注解 
上 。 


所 以 我 们 来 举 个 例子 ， 如 果 我 们 创建 了 一 个 Java 的 测试 类 : 


import org.jetbrains.annotations.Nullable; 
public class NullTest { 


@Nullable 


public Object getObject(){ 
return aa 


然后 在 Kotlin 中 使 用 : 


val test = NullTest() 
val myObject: Any = test.getObject() 


a ， 在 EE 函数 上 会 显示 一 个 敬告。 但 是 这 只 是 从 现在 才 开 始 的 


编译 器 > 并且 它 还 a 注解 ， 所 以 我 们 可 能 不 得 不 花 更 多 的 时 间 
的 方式 。 不 管 怎么 样 ， 使 用 源码 注解 的 方式 和 一 些 Androd SDK 


的 知识 ， 我 们 也 很 难 犯 错误 。 


比如 重 写 Activity 的 onCraete 函数 ， 我 们 可 以 决定 是 否 
i} savedInstanceState “null: 


override fun oncreate(savedInstanceState: Bundle?) { 


} 


override fun onCreate(savediInstanceState: Bundle) { 


} 


这 两 种 方法 都 会 被 编译 ， 但 是 第 二 种 是 错误 的 ， 因 为 一 个 Activity 很 可 能 接收 到 一 个 
null 的 bundle。 只 要 小 心 一 点 点 就 足够 了 。 当 你 有 疑问 时 ， 你 可 以 就 用 可 null 的 对 象 
然后 处 理 掉 用 可 能 的 null。 记 住 ， 如 果 你 使 用 了 11 ， 可 能 是 因为 你 确信 对 象 不 可 

能 为 null， 如果 是 这 样 ， 请 定义 为 非 null。 


这 个 灵活 性 在 Java 库 中 站 的 很 有 必要 ， 而 且 随 着 编译 器 的 进化 ， 我 们 将 可 能 看 到 更 
好 的 交互 (可 能 是 基于 注解 的 ) ， 但 是 现在 来 说 这 个 机 制 已 经 足够 灵活 了 。 


创建 业务 逻辑 来 访问 数据 


在 实现 访问 服务 器 和 与 本 地 数据 库 交 互 之 后 ， 是 时 候 把 事情 整合 起 来 了 。 逮 辑 步 
如 下 x 


o 从 数据 库 获 取 数 据 

© 检查 是 否 存 在 对 应 星期 的 数据 
ee RUF Lia # 

o 如 果 没 有 ， 请 求 服务 器 获取 数据 

° a 回 UI 泻 业 


但 是 我 们 的 commands 不 应 该 去 处 理 所 有 这 些 逻 辑 。 数 据 源 应 该 是 一 个 具体 的 实 

现 ， 这 样 就 可 以 被 容 多 地 修改 ， 所 以 增加 一 些 额外 的 代码 ， 然 后 把 command 从 数 
据 访 问 中 抽象 出 来 听 起 来 是 个 不 错 的 方式 。 在 我 们 的 实现 中 ， 它 会 遍历 整个 list 直 到 
结果 被 找到 。 


所 以 我 们 先 来 给 接口 定义 一 些 我 们 实现 provider 需要 使 用 到 的 数据 源 : 


interface ForecastDataSource { 
fun requestForecastByZipCode(zipCode: Long, date: Long): For 
ecastList? 


} 


provider 需要 一 个 接收 zip code 和 一 个 date ， 然 后 它 应 该 根据 那 一 天 返回 
一 周 的 天 气 预报 。 


class ForecastProvider(val sources: List<ForecastDataSource> = 
ForecastProvider.SOURCES) { 


companion object { 
val DAY_IN_MILLIS = 1000 * 60 * 60 * 24 
val SOURCES = listOf(ForecastDb(), ForecastServer()) 


forecast provider 接收 一 个 数据 源 列 表 ， 通 过 构造 函数 传 入 (比如 用 于 测 

试 ) ， 但 是 我 设置 了 source 的 默认 值 为 被 定义 在 companion object 中 

的 SOURCES List。 我 将 使 用 数据 库 的 数据 源 和 服务 端 数据 源 。 顺 序 是 很 重要 的 ， 因 
为 它 会 根据 顺序 去 遍历 这 个 sources， 然 后 一 旦 获取 到 有 效 的 返回 值 就 会 停止 查 
询 。 逮 辑 顺序 是 先 在 本 地 查询 〈 本 地 数据 库 中 ) ， 然 后 再 通过 API 查 询 。 
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fun requestByZipCode(zipCode: Long, days: Int): ForecastList 
= sources.firstResult { requestSource(it, days, zipC 
ode) } 


它 会 得 到 第 一 个 不 是 null 的 结果 然后 返回 。 当 我 在 第 18 章 中 讲 到 的 大 量 的 函数 操作 
符 中 搜索 后 ， 我 没有 找到 完全 符合 我 想 要 的 。 所 以 当 我 去 查看 Kotlin 的 源码 时 ， 我 
汪 了 first 函数 然后 修改 它们 来 达到 我 想 要 的 目的 : 


inline fun <T, R : Any> Iterable<T>.firstResult(predicate: (T) - 
PR) Rf 
for (element in this){ 
val result = predicate(element ) 
if (result != null) return result 


} 
throw NoSuchElementException("No element matching predicate 
was found.") 


} 


该 函数 接收 一 个 断言 函数 ， 它 接收 一 个 T 类 型 的 对 象 然后 返回 一 个 R? Se 
值 。 这 表示 predicate 可 以 返回 null 类 型 ， 但 是 我 们 的 firstResult 不 能 
null。 这 就 是 为 什么 返回 R 的 原因 。 


它 怎么 工作 呢 ? 它 将 遍 oo. 执行 这 个 断言 函数 。 当 这 个 断言 
总 数 的 结果 返回 不 是 null 时 ， 这 个 结果 就 会 


如 果 我 们 可 以 允许 Sources 返 回 null， 那 我 们 就 可 以 使 用 firstOrNull 有 函数 来 代 
替 。 不 同 之 处 就 是 最 后 一 行 的 返回 null 和 抛 异 常 。 但 是 我 现在 不 在 代码 里 面 去 处 理 
这 些 细节 了 。 


在 我 们 的 例子 中 T = ForecastDataSource > R = ForecastList 。 但 是 记 住 
在 ForecastDataSource 中 指定 的 函数 返回 一 个 ForecastList? ， 也 就 

是 R? ， 所 以 一 切 都 是 匹配 得 这 么 完美 。 requestSource 让 前 面 的 函数 看 起 来 更 
有 可 读 性 : 


fun requestSource(source: ForecastDataSource, days: Int, zipCode 
Long): 
ForecastList? { 
val res = source.requestForecastByZipCode(zipCode, todayTime 


Span()) 
return if (res != null && res.size() >= days) res else null 


如 果 结 果 不 是 null 并 且 数 量 也 参数 匹配 ， 那 这 个 查询 被 执行 且 只 会 返回 一 个 数据 。 
否则 ， 数 据 源 没 有 足够 的 数据 来 返回 一 个 成 功 的 结果 。 
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函数 todayTimeSpan() 计算 今天 毫秒 级 的 时 间 ， 并 排除 掉 “ 时 差 "*。 其 
源 〈 我 们 例子 中 的 数据 库 ) 可 能 会 需要 它 。 因 为 如 果 我 们 没有 指定 更 多 的 信息 ， 服 
务 端 默认 就 是 今天 ， 所 以 我 们 不 需要 设置 它 。 


private fun todayTimeSpan() = System.currentTimeMillis() / DAY_I 
N_MILLIS * DAY_IN_MILLIS 


这 个 类 完整 的 代码 如 下 : 


class ForecastProvider(val sources: List<ForecastDataSource> = 
ForecastProvider.SOURCES) { 


companion object { 
val DAY TN MILLIS = 1000 * 60 * 60 * 24: 
val SOURCES = listOf(ForecastDb(), ForecastServer()) 


fun requestByZipCode(zipCode: Long, days: Int): ForecastList 
= sources.firstResult { requestSource(it, days, zipC 
ode) } 


private fun requestSource(source: RepositorySource, days: In 
t, 
zipcode: Long): Forecasthist? { 
val res = source.requestForecastByZipCode(zipCode, today 
TimeSpan()) 


return if (res != null && res.size() >= days) res else n 
ull 
} 
private fun todayTimeSpan() = System.currentTimeMillis() / 
DAY_IN_MILLIS * DAY_IN_MILLIS 
} 


我 们 已 经 定义 了 一 个 ForecastDb 。 现 在 我 们 需要 去 实 
现 ForcastDataSource 


class ForecastDb(val forecastDbHelper: ForecastDbHelper = 
ForecastDbHelper.instance, val dataMapper: DbDataMapper 
= DbDataMapper() ) 
: ForecastDataSource { 


override fun requestForecastByZipCode(zipCode: Long, date: L 
ong) = 
forecastDbHelper.use { 


ForecastServer 还 没有 还 被 实现 ， 但 是 这 是 非常 简单 的 。 它 在 从 服务 端 接收 到 
数据 之 后 就 会 使 用 ForecastDb 去 保存 到 数据 库 。 用 这 种 方式 ， 我 们 就 可 以 缓存 
这 些 数据 到 数据 库 中 ， 提 供给 以 后 的 查询 。 


class ForecastServer(val dataMapper: ServerDataMapper = ServerDa 


taMapper(), 
val forecastDb: ForecastDb = ForecastDb()) : ForecastDat 


aSource { 


override fun requestForecastByZipCode(zipCode: Long, date: L 
ong): 
ForecastList? { 
val result = ForecastByZipCodeRequest(zipCode) .execute() 
val converted = dataMapper.convertToDomain(zipCode, resu 


1t) 
forecastDb.saveForecast(converted) 
return forecastDb.requestForecastByZipCode(zipCode, date 
) 
} 
} 


它 也 是 使 用 了 之 前 我 们 创建 的 data mapper ， 最 然 我 们 修改 一 些 函 数 的 名 字 来 让 
它 更 加 与 我 们 之 前 用 在 database model 的 mapper 更 相似 。 你 可 以 查 
看 provider 来 查看 细节 。 


被 重 写 的 方法 用 来 请 求 服务 器 ， 转 换 结 果 到 domain objects 并 保存 它们 到 数据 
库 。 它 最 后 查询 数据 库 返 回 数据 ， 这 是 因为 我 们 需要 使 用 到 插入 到 数据 库 中 的 字 增 
kid ° 


这 就 是 provider 被 实现 的 最 后 的 一 步 了 。 现 在 我 们 需要 开始 使 用 


È ° ForecastCommand 不 会 再 直接 与 服务 端 交 互 ， 也 不 会 转换 数据 到 domain 
model ° 


RequestForecastCommand(val zipCode: Long, 


val forecastProvider: ForecastProvider = ForecastProvide 


r()) 


Command<ForecastList> { 


companion object { 
val DAYS = 7 


override fun execute(): ForecastList { 


return forecastProvider.requestByZipCode(zipCode, DAYS) 


其 它 修改 的 地 方 包 括 重 命名 和 包 的 结构 调整 。 在 Kotlin for Android Developers 
repository 查 看 相应 的 提交 。 


Flow control 和 ranges 


我 在 我 们 的 代码 中 使 用 了 一 些 条 件 表 达 式 ， 但 是 现在 是 时 候 去 更 深 地 去 解释 它们 

了 。 我 们 通常 都 在 使 用 过 程式 编程 语言 的 时 候 很 少 地 去 使 用 代码 流 控 制 的 机 制 去 编 
E (有 些 过 程式 编程 语言 中 几乎 已 消失 ) ， 但 是 它们 还 是 很 有 用 的 。 这 也 是 一 个 新 
的 强大 的 想法 让 解决 一 些 特定 的 情况 下 的 问题 变 得 更 容易 。 


上 f 表 达 式 


在 Kotlin 中 一 切 都 是 表达 式 ， 也 就 是 说 一 切 都 返回 一 个 值 。 如 果 if 条 件 不 含有 一 


个 exception， 那 我 们 可 以 像 我 们 平时 那样 使 用 它 : 


if(x>0){ 

toast("x is greater than 0") 
selse if (x==0){ 

toast("x equals 0") 
selse{ 

toast("x is smaller than 0") 


我 们 也 可 以 把 结果 赋值 给 一 个 变量 。 我 们 在 我 们 的 代码 中 使 用 了 很 多 次 : 


val res = if (x != null && x.size() >= days) x else null 


al 


val z = if (condition) x else y 


aaa 需要 像 Java 那 种 有 一 个 三 元 操作 符 ， 因 为 我 们 可 以 使 用 它 来 简单 实 


所 以 if 表达 式 总 是 返回 一 个 value。 如 果 一 个 分 支 返 回 了 Unit， 那 整个 表达 式 也 将 
返回 Unit， 它 是 可 以 被 忽略 的 ， 这 种 情况 下 它 的 用 法 也 就 跟 一 般 Java 中 的 if 条 件 


一 样 了 。 


When 表达 式 


when 表达 式 与 Java 中 的 switch/case 类 似 ， 但 是 要 强大 得 多 。 这 个 表达 式 会 去 
试图 匹配 所 有 可 能 的 分 支 直 到 找到 满意 的 一 项 。 然 后 它 会 运行 右边 的 表达 式 。 与 
Java 的 switch/case 不 同 之 处 是 参数 可 以 是 任何 类 型 ， 并 且 分 支 也 可 以 是 一 个 条 
件 。 


对 于 默认 的 选项 ， 我 们 可 以 增加 一 个 else 分 支 ， 它 会 在 前 面 没 有 任何 条 件 匹 配 时 
再 执行 。 条 件 匹 配 成 功 后 执行 的 代码 也 可 以 是 代码 块 : 


when (x){ 
1 -> print("x == 1" 
2 -> print("x == 2 
else -> { 
print("I'm a block") 
print("x is neither 1 nor 2") 


因为 它 是 一 个 表达 式 ， 它 也 可 以 返回 一 个 值 。 我 们 需要 考虑 什么 时 候 作为 一 个 表达 
式 使 用 ， 它 必须 要 和 履 盖 所 有 分 支 的 可 能 性 或 者 实现 else 分 支 。 否 则 它 不 会 被 编译 
成 功 : 


val result = when (x) { 
©, 1 => “binary” 
else -> "error" 


如 你 所 见 ， 条 件 可 以 是 一 系列 被 过 号 分 割 的 值 。 但 是 它 可 以 更 多 的 匹配 方式 。 比 
如 ， 我 们 可 以 检测 参数 类 型 并 进行 判断 : 


when(view) { 
is TextView -> view.setText("I'm a TextView") 
is EditText -> toast("EditText value: ${view.getText()}") 
is ViewGroup -> toast("Number of children: ${view.getChildCo 


unt()} ") 


else -> view.visibility = View.GONE 


再 条 件 右 边 的 代码 中 ， 参 数 会 被 自动 转型 ， 所 以 你 不 需要 去 明确 地 做 类 型 转换 。 


它 还 让 检测 参数 否 在 一 个 数组 范围 其 至 是 集合 范围 成 为 可 能 (我 会 在 这 章节 的 后 面 
讲 这 个 ) 


val cost = when(x) { 
in 1..10 -> "cheap" 
in 10..100 -> "regular" 
in 100..1000 -> "expensive" 
in specialValues -> "special value!" 
else -> "not rated" 


或 者 你 甚至 可 以 从 对 参数 做 需要 的 几乎 疯狂 的 检查 摆脱 出 来 。 它 可 以 使 用 简单 
的 if/else 链 替 代 : 


valres=when{ 
x in d..10--> “cheap” 
s.contains("hello") -> "it's a welcome!" 
v is ViewGroup -> "child count: ${v.getChildCount()}" 
else -> "" 


For 35 


虽然 你 在 使 用 了 collections 的 函数 操作 符 之 后 不 会 再 过 多 地 使 用 for 循 环 ， 但 是 for 循 
环 再 一 些 情况 下 仍然 是 很 有 用 的 。 提 供 一 个 和 迭代 器 它 可 以 作用 在 任何 东西 上 面 : 


for (item in collection) { 
print(item) 


如 果 你 需要 更 多 使 用 index 的 典型 的 选 代 ， 我 们 也 可 以 使 用 ranges (反正 它 通 常 
是 更 加 智能 的 解决 方案 ) 


for (index in 0..viewGroup.getChildCount() - 1) { 
val view = viewGroup.getChildAt (index) 
view.visibility = View.VISIBLE 


在 我 们 迭代 一 个 array 或 者 list， 一 系列 的 index 可 以 用 来 获取 到 指定 的 对 象 ， 所 以 上 
面 的 方式 不 是 必要 的 : 


for (i in array.indices) 
print(array[i] ) 


While #- do/while4 37 


你 也 可 以 使 用 while 循环 ， 尽 管 它们 两 个 都 不 是 特别 常用 的 。 它 们 通常 可 以 更 简 
单 、 视 觉 上 更 容易 理解 的 方式 去 解决 一 个 问题 ， 两 个 例子 : 


while(x > O){ 


val y = retrieveData() 
} while (y != null) // y 在 这 里 是 可 见 的 ! 


Ranges 


很 难 解释 control flow ， 如 果 不 去 讲 讲 ranges 的 话 。 但 是 它们 的 范围 要 宽 得 
多 。 Range 表达 式 使 用 一 个 .. 操作 符 ， 它 是 被 定义 实现 了 一 个 RangTo 方法 。 


Ranges 帮助 我 们 使 用 很 多 富有 创造 性 的 方式 去 简化 我 们 的 代码 。 比 如 我 们 可 以 把 


if(i >= 0 && i <= 10) 
println(i) 


转化 成 : 


(ln ll 
println(i) 


Cag 被 定义 为 可 以 被 比较 的 任意 类 型 ， 但 是 对 于 数字 类 型 ， 比 较 器 会 通过 转换 

为 简单 的 类 似 Java 代 码 来 避免 额外 开销 的 方式 来 优化 它 。 数 字 类 型 的 ranges 也 
es 代 ， 编 译 器 会 转换 它们 为 与 Java 中 使 用 index 的 for 循 环 的 相同 字 节 码 的 方 
式 来 进行 优化 : 


for (iin 62.16) 
println(i) 


Ranges 默认 会 自 增长 ， 所 以 如 果 像 以 下 的 代码 : 


FOF (a a O e 
println(i) 


它 就 不 会 做 任何 事情 。 但 是 你 可 以 使 用 downto 函数 : 


for(i in 10 downTo 0) 
println(i) 


我 们 可 以 在 range 中 使 用 step 来 定义 一 个 从 1 到 一 个 值 的 不 同 的 空 障 : 
for (i in 1..4 step 2) printin(i) 


for (i in 4 downTo 1 step 2) println(i) 


如 果 你 想 去 创建 一 个 open range (不 包含 最 后 一 项 ， 译 者 注 : 类 似 数 学 中 的 开 区 
lal) ， 你 可 以 使 用 until 函数 : 


for (i in © until 4) println(i) 


这 一 行 会 打印 从 0 到 3， 但 是 会 跳 过 最 后 一 个 值 。 这 也 就 是 说 9 until 4 == 
0..3 。 在 一 个 list 中 和 迭代 时 ， 使 用 (i in © until list.size) 比 (i in 
0..list.size - 1) 更 加 容易 理解 。 


就 如 之 前 所 提 到 的 ， 使 用 ranges 确实 有 富有 创造 性 的 方式 。 比 如 ， 一 个 简单 的 方 
式 去 从 一 个 ViewGroup 中 得 到 一 个 Views 列 表 可 以 这 么 做 : 


val views = (0..viewGroup.childCount - 1).map { viewGroup.getChi 
1dAt(it) } 


混合 使 用 ranges 和 函数 操作 符 可 以 避免 我 们 使 用 明确 地 循环 去 迭代 一 个 集合 ， 
还 有 明确 地 去 创建 一 个 我 们 用 来 添加 views 的 list。 所 有 的 事情 都 在 一 行 代码 中 做 好 
了 fe} 


如 果 你 想 知 道 更 多 ranges 的 实现 方式 和 更 多 的 范例 和 游泳 的 信息 ， 你 可 以 进 
入 Kotlin reference 


创建 一 个 详情 界面 


当 我 们 在 主屏 幕 上 点 击 了 一 项 ， 我 们 硕 望 跳 转 到 一 个 详情 界面 并 且 可 以 看 到 一 些 关 
于 那天 天 气 预 报 的 额外 信息 。 我 们 当前 点 击 了 一 项 之 后 只 是 显示 了 一 个 toast， 但 是 
现在 是 时 候 去 修改 它 了 。 


准备 请 求 


因为 我 们 需要 知道 哪 一 个 item 我 们 要 在 详情 界面 中 显示 出 来 ， 所 以 逻辑 告诉 我 们 需 
要 发 送 一 个 天 气 预 报 的 id 到 详情 界面 。 所 以 domain model 需要 一 个 新 
的 id 属性 : 


data class Forecast(val id: Long, val date: Long, val description 
: String, 
Val high: int, val low: Int, val iconWrl: String) 


B — 


ForecastProvider 也 需要 一 个 新 的 函数 ， 它 返回 通过 id 请 求 后 的 结 

果 。 DetailActivity 将 需要 通过 接收 到 的 id 来 执行 请 求 获 取 天 气 预报 数据 。 
因为 所 有 的 请 求 都 会 迭代 所 有 的 数据 源 并 且 返 回 第 一 个 非 null 的 结果 ， 我 们 可 以 抽 
取 并 定义 一 个 新 的 函数 


private fun <T : Any> requestToSources(f: (ForecastDataSource) - 
> T2): T 
= sources.firstResult { f(it) } 


回 一 个 可 null 的 对 
回 一 个 可 null 范 型 


这 个 函数 使 用 一 个 非 null 类 型 作为 范 型 。 它 会 接收 一 个 函数 ， 并 返 
象 。 其 中 这 个 接收 的 函数 接收 一 个 ForecastDataSource ， 并 返 


的 对 象 。 o 我 们 可 以 重 写 上 一 个 请 求 并 如 下 写 一 个 新 的 : 


fun requestByZipCode(zipCode: Long, days: Int): ForecastList = r 
equestToSources { 
val res = it.requestForecastByZipCode(zipCode, todayTimeSpan 


()) 


if (res != null && res.size() >= days) res else null 


fun requestForecast(id: Long): Forecast = requestToSources { 
it.requestDayForecast (id) 


现在 数据 源 需要 去 实现 一 个 新 的 函数 


fun requestDayForecast(id: Long): Forecast? 


ForcastDb 将 总 是 会 拿 到 所 需 的 在 上 一 次 请 求 被 缓存 的 值 ， 所 以 我 们 可 以 通过 这 
种 方式 去 获取 它 


override fun requestDayForecast(id: Long): Forecast? = forecastD 
bHelper.use { 
val forecast = select(DayForecastTable.NAME).byId(id). 
parseOpt { DayForecast(HashMap(it)) } 
if (forecast != null) dataMapper.convertDayToDomain( forecast 
) else null 


} 


select 从 查询 与 之 前 的 非常 相似 。 我 创建 了 另 一 个 名 为 byId 的 工具 函数 ， 
为 通过 id 来 请 求 是 很 通用 的 ， 像 这 样 使 用 一 个 函数 可 以 简化 处 理 过 程 也 更 具 可 读 
性 。 了 有 函数 的 实现 也 是 相当 简单 : 


fun SelectQueryBuilder.byId(id: Long): SelectQueryBuilder 
= whereSimple("_id = ?", id.toString()) 


它 只 是 使 用 了 whereSimple 有 函数 实现 使 用 id 字段 来 查询 数据 。 ee 当 
普通 ， 但 是 如 你 所 见 ， 你 可 以 根据 你 数据 库 结 构 的 需要 来 创建 需要 的 扩展 函 

可 以 大 量 地 简化 你 代码 的 可 读 性 。 DataMapper ee o 
你 可 以 通过 代码 库 来 查看 它们 。 


另 一 方面 ， ForecastServer 将 不 会 再 使 用 ， 因 为 信息 总 是 会 被 缓存 在 数据 库 
中 。 我 们 可 以 在 一 些 奇 怪 的 场景 下 实现 一 些 代码 保护 ， 但 是 我 们 在 这 个 例子 中 没有 
做 任何 处 理 ， 所 以 如 果 发 生 它 也 会 只 是 抛 出 一 个 异常 


override fun requestDayForecast(id: Long): Forecast? 
= throw UnsupportedOperationException( ) 


YE 备 请 来 


try 和 throw 是 表达 式 


在 Kotlin 中 ， 几 乎 一 切 都 是 表达 式 ， 也 就 是 说 一 切 都 会 返回 一 个 值 。 这 在 函 
数 式 编程 中 是 非常 重要 的 ， 当 你 使 用 try-catch 处 理 边界 的 问题 或 者 当 
抛 出 异常 的 时 候 。 比 如 ， 在 上 一 个 例子 中 ， 我 们 可 以 给 结果 分 配 一 个 
exception 就 算 他 们 不 是 相同 的 类 型 ， 而 不 是 必须 要 去 创建 一 个 完整 的 代码 
块 。 当 我 们 需要 在 一 个 when 分 支 中 抛 出 一 个 exception 的 时 候 也 是 非常 有 
用 : 


val x = when(y){ 
in OS LQ) =" 
Un aabo aA > 
else -> throw Exception("Invalid") 


try-catch 中 也 是 一 样 ， 我 们 可 以 根据 try 的 结果 分 配 一 个 值 : 


val x = try{ doSomething() }catch{ null } 


最 后 一 件 我 们 需要 做 的 事 就 是 在 新 的 activity 中 创建 一 个 command 来 执行 请 求 : 


class RequestDayForecastCommand( 
Val id: Long, 


val forecastProvider: ForecastProvider = ForecastProvide 
r()) 


Command<Forecast> { 


override fun execute() = forecastProvider .requestForecast (id) 


} 
ee 条 


请 求 返回 一 个 将 用 于 activity 绘 制 UI 的 Forecast 结果 。 
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提供 一 个 新 的 activity 


现在 我 们 准备 去 创建 一 个 DetailActivity 。 我 们 详情 activity 将 会 接收 一 组 从 主 
activity 传 过 来 的 参数 : forecast id 和 城市 名 称 。 第 一 个 参数 将 会 用 来 从 数据 
库 中 请 求 数据 ， 城 市 名 称 用 于 显示 在 toolbar 上 。 所 以 我 们 首先 需要 定义 一 组 参数 的 


名 字 : 
public class DetailActivity : AppCompatActivity() { 
companion object { 
val ID = "DetailActivity:id" 
val CITY_NAME = "DetailActivity:cityName" 
} 
} 


在 onCreate 函数 中 ， 第 一 步 是 去 设置 content view。 Ul 是 非常 简单 的 ， 但 是 对 于 
这 个 app 来 说 是 足够 了 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:tools="http://schemas.android.com/tools" 


android: layout_width="match_parent" 

android: layout_height="match_parent" 

android: orientation="vertical" 

android: paddingBottom="@dimen/activity_vertical_margin" 
android: paddingLeft="@dimen/activity_horizontal_margin" 
android: paddingRight="@dimen/activity_horizontal_margin" 
android: paddingTop="@dimen/activity_vertical_margin"> 
<LinearLayout 


android: layout_width="match_parent" 


android: layout_height="wrap_content" 


android: orientation="horizontal" 


android: gravity="center_vertical" 


tools:ignore="UseCompoundDrawables"> 


<ImageView 
android: 
android: 
android: 


id="@+id/icon" 
layout_width="64dp" 
layout_height="64dp" 


tools:src="@mipmap/ic_launcher" 


tools:ignore="ContentDescription"/> 


<TextView 
android: 
android: 
android: 
android: 
android: 
pat .Displayi" 


id="@+id/weatherDescription" 
layout_width="wrap_content" 
layout_height="wrap_content" 
layout_margin="@dimen/spacing_xlarge" 
textAppearance="@style/TextAppearance 


tools: text="Few clouds"/> 


</LinearLayout> 
<LinearLayout 


android: layout_width="match_parent" 


android: layout_height="wrap_content"> 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
pat .Display3" 


id="@+id/maxTemperature" 
layout_width="O0dp" 
layout_height="wrap_content" 
layout_weight="1" 
layout_margin="@dimen/spacing_xlarge" 
gravity="center_horizontal" 
textAppearance="@style/TextAppearance 


tools: text="30"/> 


<TextView 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
pat .Display3" 


id="@+id/minTemperature" 
layout_width="0dp" 
layout_height="wrap_content" 
layout_weight="1" 
layout_margin="@dimen/spacing_xlarge" 
gravity="center_horizontal" 
textAppearance="@style/TextAppearance 


tools: text="10"/> 


</LinearLayout> 


.AppCom 


.AppCom 


.AppCom 


</LinearLayout> 


REE onCreate 代码 中 去 设置 它 。 使 用 城市 的 名 字 设 置 成 toolbar 的 
title。 intent 和 title 通过 下 面 的 方法 被 自动 影射 到 属性 : 


setContentView(R.layout.activity_detail) 
title = intent.getStringExtra(CITY_NAME) 


onCreate 实现 的 另 一 部 分 是 调用 command。 这 与 我 们 之 前 做 的 非常 相似 : 


async { 

val result = RequestDayForecastCommand(intent.getLongExtr 
a(ID, -1)).execute() 

uiThread { bindForecast(result) } 


当 结 果 从 数据 库 中 获取 之 后 ， bindForecast BREVIAE? RA o RATE 
个 activity 中 又 一 次 使 用 了 Kotlin Android Extensions 插 件 来 实现 不 使 
用 findViewById 来 从 XML 中 获取 到 属性 : 


import kotlinx.android.synthetic.activity_detail.* 


private fun bindForecast(forecast: Forecast) = with(forecast) { 
Picasso.with(ctx).load(iconUr1).into(icon) 
supportActionBar.subtitle = date.toDateString(DateFormat. 


FULL) 

weatherDescription.text = description 

bindWeather(high to maxTemperature, low to minTemperature 
) 
} 


这 里 有 一 些 有 趣 的 地 方 。 比 如 ， 我 创建 了 另 一 个 扩展 函数 来 转换 一 个 Long 对 象 到 
一 个 用 于 显示 的 日 期 字符 串 。 记 住 我 们 在 adapter 中 也 使 用 了 ， 所 以 明确 定义 它 为 一 
个 函数 是 个 不 错 的 实践 : 


fun Long.toDateString(dateFormat: Int = DateFormat.MEDIUM): Stri 


ng { 

val df = DateFormat.getDateInstance(dateFormat, Locale.getDe 
fault()) 

return df.format(this) 


我 会 得 到 一 个 date format (或 者 使 用 默认 的 DateFormat.MEDIUM) 并 转 
换 Long 为 一 个 用 户 可 以 理解 的 String 。 


另 一 个 有 趣 的 地 方 是 bindweather 有 函数 。 它 会 接收 一 个 vararg 的 
由 Int 和 TextView 组 成 的 pairs ， 并 且 根 据 温 度 给 TextView 设置 不 同 
的 text 和 text color 。 


private fun bindweather(vararg views: Pair<Int, TextView>) = Vie 
ws.forEach { 
it.second.text = "${it.first.toString()}" 
it.second.textColor = color(when (it.first) { 
in -50..0 -> android.R.color.holo_red_dark 
in 0..15 -> android.R.color.holo_orange_dark 
else -> android.R.color.holo_green_dark 


1) 


每 一 个 pair， 它 会 设置 一 个 text 来 显示 温度 和 一 个 根据 温度 匹配 的 不 同 的 颜色 : 
低温 度 用 红色 ， 中 温度 用 票 色 ， 其 它 用 绿色 。 温 度 值 是 比较 随机 的 ， 但 是 这 个 是 使 
用 when 表达 式 让 代码 变 得 简短 精炼 的 很 好 的 代表 。 


color 是 我 想念 的 Anko 中 的 一 个 扩展 函数 ， 它 可 以 很 简洁 的 方式 从 resources 中 
获取 一 个 color， 类 似 于 我 们 在 其 它 地 方 使 用 到 的 dimen 。 我 们 写 下 这 一 行 的 时 
候 ， 当 前 support library 依赖 ContextCompat 来 从 不 同 的 Android 版 本 中 获 
取 一 个 color : 


public fun Context.color(res: Int): Int = ContextCompat.getColor 
(this, res) 


AndroidManifest 也 需要 知道 新 activity 的 存在 : 


<activity 
android: name=".ui.activities.DetailActivity" 
android: parentActivityName=".ui.activities.MainActivity" > 
<meta-data 
android: name="android. support .PARENT_ACTIVITY" 
android: value="com.antonioleiva.weatherapp.ui.activities 
.MainActivity" /> 
</activity> 


尼 动 一 个 activity : reified 4 2 


最 后 一 步 是 从 main activity 启动 一 个 detail activity 。 我 们 可 以 如 下 重 写 
adapter 实 例 : 


val adapter = ForecastListAdapter(result) { 
val intent = Intent(MainActivity@this, javaClass<DetailActiv 
ity>()) 
intent.putExtra(DetailActivity.ID, it.id) 
intent.putExtra(DetailActivity.CITY_NAME, result.city) 
startActivity(intent) 


但 是 这 是 非常 元 长 的 。 一 如 既往 地 ，Anko 提 供 了 简单 得 多 的 方式 通过 reified 
function 来 启动 一 个 activity : 


val adapter = ForecastListAdapter(result) { 
startActivity<DetailActivity>(DetailActivity.ID to it.id, 
DetailActivity.CITY_NAME to result.city) 


reified function 背后 到 底 有 什么 魔法 呢 ? 就 像 你 可 能 知道 的 那样 ， 当 我 们 在 
Java 中 创建 一 个 范 型 函数 ， 我 们 没有 办 法 得 到 范 型 类 型 的 Class。 一 个 流行 的 变通 
方法 是 作为 参数 传 入 一 个 Class。 在 Kotlin 中 ， 一 个 内 联 ( inline ) BATARA 
WAG ( reified ) ， 这 意味 着 我 们 可 以 在 函数 中 得 到 并 使 用 范 型 类 型 的 Class。 
Anko 申 正 使 用 它 的 一 个 简单 的 例子 接 下 来 会 讲 到 (在 这 个 例子 中 我 只 使 用 
了 String ) 


public inline fun <reified T: Activity> Context.startActivity( 
vararg params: Pair<String, String>) { 
val intent = Intent(this, T::class.javaClass) 
params forEach { intent.putExtra(it.first, it.second) } 
startActivity(intent) 


真 正 的 实现 要 更 加 复杂 一 点 因为 它 使 用 了 一 个 很 长 的 令 人 讨厌 的 when 表达 式 来 增 
加 由 类 型 决定 的 额外 信息 ， 但 是 在 概念 上 来 说 它 没 有 增加 其 它 更 有 用 的 知识 。 

Reified 函数 是 有 一 个 可 以 简化 代码 和 提高 理解 性 的 语法 糖 。 在 这 个 例子 中 ， 它 
通过 获取 到 了 范 型 类 型 的 javaclass 来 创建 了 一 个 intent， 和 迭代 所 有 参数 并 增加 到 
intent， 然 后 使 用 Intent 来 启动 activity。 reified 限制 于 activity 的 子 类 。 


剩 下 的 一 点 细节 在 代码 库 中 已 经 说 明 。 我 们 现在 有 一 个 非常 简单 (但 是 完整 ) 的 主 
从 视图 ( master-detail ) 的 App， 它 使 用 Kotlin 实 现 ， 没 有 使 用 一 行 Java 代 码 。 


接口 


Kotlin 中 的 接口 比 Java 7 中 要 强大 得 多 。 如 果 你 使 用 Java 8， 它 们 非常 相似 。 在 
Kotlin 中 ， 我 们 可 以 像 Java 中 那样 使 用 接口 。 想 象 我 们 有 一 些 动 物 ， 它 们 的 其 中 一 
些 可 以 飞行 。 这 个 是 我 们 针对 飞行 动物 的 接口 : 


interface FlyingAnimal { 
fun fly() 


乌 和 蝙蝠 都 可 以 通过 局 动 翅膀 的 方式 飞行 。 所 以 我 们 为 它们 创建 两 个 类 : 


class Bird : FlyingAnimal { 
val wings: Wings = Wings() 
override fun fly() = wings.move() 


class Bat : FlyingAnimal { 
val wings: Wings = Wings() 
override fun fly() = wings.move() 


当 两 个 类 继承 自 一 个 接口 ， 非 常 典型 的 是 它们 两 者 共享 相同 的 实现 。 但 是 Java 7 中 
的 接口 只 能 定义 行为 ， 但 是 不 能 去 实现 它 。 


Kotlin 接 口 在 某 一 方面 它 可 以 实现 函数 。 它 们 与 类 唯一 的 不 同 之 处 是 它们 是 无 状态 
(stateless) 的 ， 所 以 属性 需要 子 类 去 重 写 。 类 需要 去 负责 保存 接口 属性 的 状态 。 


我 们 可 以 让 接口 实现 fly BHA: 


interface FlyingAnimal { 
val wings: Wings 
fun fly() = wings.move() 


就 像 提 到 的 那样 ， 类 需要 去 重 写 属性 : 


class Bird : FlyingAnimal { 
override val wings: Wings 


class Bat : FlyingAnimal { 
override val wings: Wings 


现在 鸟 和 蝙蝠 都 可 以 飞行 了 : 


val bird = Bird() 
val bat = Bat() 


bird. fly() 
bat.fly() 


Wings() 


Wings() 


委托 


委托 模式 是 一 个 很 有 用 的 模式 ， 它 可 以 用 来 从 类 中 抽取 出 主要 负责 的 部 分 。 委 托 模 
式 是 Kotlin 原 生 支持 的 ， 所 以 它 避 免 了 我 们 需要 去 调用 委托 对 象 。 委 托 者 只 需要 指 
定 实现 的 接口 的 实例 。 


在 我 们 前 面 的 例子 中 ， 我 们 可 以 通过 构造 函数 指定 动物 怎么 飞行 ， 而 不 是 实现 它 。 
比如 ， 一 个 使 用 翅膀 飞行 的 动物 可 以 用 这 种 方式 指定 : 


interface CanFly { 
fun fly() 


class Bird(f: CanFly) : CanFly by f 


我 们 可 以 使 用 接口 来 指示 鸟 可 以 飞行 ， 但 是 鸟 的 飞行 方式 被 定义 在 一 个 委托 中 ， 这 
个 委托 定义 在 构造 函数 中 ， 所 以 我 们 可 以 针对 不 同 的 鸟 使 用 不 同 的 飞行 方式 。 动 物 
使 用 翅膀 飞行 的 方式 被 定义 在 另 一 个 类 中 : 


class AnimalWithWings : CanFly { 


val wings: Wings = Wings() 
override fun fly() = wings.move() 


动物 扇 动 翅膀 来 飞行 。 所 以 我 们 可 以 创建 一 个 乌 ， 它 使 用 翅膀 飞行 : 


val birdWithWings = Bird(Animalwithwings()) 
birdwithwings.fly() 


但 是 现在 翅膀 可 以 被 别 的 不 是 乌 类 的 动物 使 用 。 如 果 我 们 假设 蝙蝠 使 用 翅膀， 我 们 
可 以 直接 指定 委托 来 实例 化 对 象 : 


class Bat : CanFly by AnimalWithWings() 


val bat = Bat() 
bat.fly() 


在 我 们 的 App 中 实现 一 个 例子 


接口 可 以 被 用 来 从 类 中 提取 出 相似 行为 的 通用 代码 。 上 比如， 我 们 可 以 创建 一 个 接口 
用 于 处 理 app 的 toolbar。 MainActivity 和 DetailActivity 在 处 
理 toolbar 时 会 共享 这 些 相 似 的 代码 。 


但 是 受 限 ， 我 们 需要 做 出 一 些 改变 ， 使 用 被 定义 在 布局 中 toolbar ， 而 不 是 标准 
的 ActionBar 。 第 一 件 事 是 继承 NoActionBar 主题 。 这 样 toolbar 不 会 自动 
被 包含 进来 : 


<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar 
1> 

<item name="colorPrimary">#ff212121</item> 

<item name="colorPrimaryDark">@android:color/black</item> 
</style> 


我 们 使 用 ligit 主题 。 然 后 我 们 创建 一 个 toolbar 的 布局 ， 我 们 稍 后 会 在 其 它 
的 布局 中 使 用 到 它 : 


<android.support.v7.widget.Toolbar 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: id="@+id/toolbar" 
android: layout_width="match_parent" 
android: layout_height="?attr/actionBarSize" 
android: background="?attr/colorPrimary" 
app: theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 
app : popupTheme="@style/ThemeOverlay.AppCompat.Light"/> 


toolbar 指定 了 它 自己 的 背景 ， 一 个 针对 自己 的 dark 主题 和 一 个 针对 生成 的 弹 
出 框 的 light 主题 ( overflow menu 实例 ) 。 我 们 现在 已 经 有 了 相同 的 主 
aL: light 主题 和 dark 主题 的 Action Bar ° 


下 一 步 我 们 将 修改 MainActivity 的 布局 ， 增 加 一 个 toolbar : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="match_parent"> 


<android.support.v7.widget .RecyclerView 
android: id="@+id/forecastList" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android:clipToPadding="false" 
android: paddingTop="?attr/actionBarSize"/> 


<include layout="@layout/toolbar"/> 
</FrameLayout> 


现在 toolbar 被 增加 到 布局 中 ， 我 们 可 以 开始 使 用 它 。 我 们 创建 了 一 个 接口 ， 它 可 以 
让 我 们 : 

e 改变 title 

o 指定 是 否 显示 上 一 步 的 导航 动作 

e 滚动 时 的 toolbar 动 画 

e 给 所 有 的 activity 设 置 相同 的 菜单 ， 甚 至 行为 


然后 让 我 们 定义 ToolbarManager 


interface ToolbarManager { 
val toolbar: Toolbar 


它 将 需要 一 个 toolbar 属 性 。 接 口 是 无 状态 的 ， 所 以 属性 可 以 被 定义 ， 但 是 不 能 赋 
值 。 子 类 会 实现 这 个 接口 并 重 写 这 个 属性 。 

另 一 方面 ， 我 们 可 以 不 使 用 重 写 来 实现 无 状态 的 属性 。 也 就 是 说 属性 不 需要 维护 一 
个 backup field 。 一 个 处 理 toolbar title 属 性 的 例子 : 


var toolbarTitle: String 
get() = toolbar.title.toString() 
set(value) { 
toolbar.title = value 


为 属性 仅仅 使 用 了 toolbar， 它 不 需要 保存 任何 新 的 状态 。 


我 们 现在 创建 了 一 个 新 的 函数 用 来 初始 化 toolbar ，inflate 一 个 menu 并 且 设 置 一 个 
listener : 


fun initToolbar(){ 
toolbar .inflateMenu(R.menu.menu_main) 
toolbar.setOnMenuItemClickListener { 
when (it.itemiId) { 
R.id.action_settings -> App.instance.toast("Settings" 


else -> App.instance.toast("Unknown option") 


} 


Give 
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我 们 可 以 增加 一 个 函数 用 来 开局 toolbar 上 面 导 航 icon， 设 置 一 个 箭头 的 icon 并 设置 
一 个 当 icon 被 按压 时 触发 的 事件 : 


fun enableHomeAsUp(up: () -> Unit) { 
toolbar.navigationIcon = createUpDrawable() 
toolbar.setNavigationOnClickListener { up() } 


} 
private fun createUpDrawable() = with (DrawerArrowDrawable(toolb 
aie CEUX) 4. 

progress = 1f 

this 


这 个 函数 接收 一 个 listener， 使 用 DrawerArrowDrawable 来 创建 一 个 最 后 状态 〈 当 痹 
头 已 经 显示 时 ) 的 drawable， 然 后 把 listener 设 置 给 toolbar 。 


最 后 ， 接 口 将 会 提供 一 个 函数 ， 它 允许 toolbar 可 以 attached 到 一 个 scroll 上 面 ， 并 且 
根据 scroll 的 方向 来 执行 动画 。 当 往 下 滚动 时 toolbar 会 消失 ， 往 上 滚动 toolbar 会 再 
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fun attachToScroll(recyclerView: RecyclerView) { 
recyclerView.addOnScrollListener(object : RecyclerView.OnScr 
ollListener() { 
override fun onScrolled(recyclerView: RecyclerView?, dx: 
Tn CMa MUE) e 
if (dy > 0) toolbar.slideExit() else toolbar .slideEn 
ter() 


}) 


我 们 会 创建 两 个 用 于 view 从 屏幕 中 显示 或 者 消失 动画 的 扩展 函数 。 我 们 会 检查 
动画 之 前 没有 执行 过 。 这 种 方式 可 以 避免 每 次 不 同 的 滚动 view 都 会 执行 动画 : 


fun View.slideExit() { 

if (translationY == Of) animate().translationY(-height.toFla 
t()) 
} 


fun View.slideEnter() { 
if (translationyY < Of) animate().translationy(0f) 


在 toobar manager 实现 之 后 ， 有 是 时 候 在 MainActivity 中 使 用 它 了 。 我 们 首先 
指定 toolbar 属 性 。 我 们 可 以 使 用 lazy 委托 实现 ， 这 样 会 在 我 们 第 一 次 使 用 它 的 时 
候 才 会 inflate : 


override val toolbar by lazy { find<Toolbar>(R.id.toolbar) } 


MainActivity 将 会 仅仅 初始 化 toolbar 并 attach 到 RecyclerView 的 滚动 并 修改 
toolbar 的 title : 


override fun onCreate(savediInstanceState: Bundle?) { 

super .onCreate(savedInstanceState) 

setContentView(R.layout.activity_main) initToolbar() 
forecastList.layoutManager = LinearLayoutManager (this) 
attachToScroll(forecastList) 


async { 
val result = RequestForecastCommand (94043) .execute() 
uiThread { 
val adapter = ForecastListAdapter(result) { 
startActivity<DetailActivity>(DetailActivity.ID to i 
trid 
DetailActivity.CITY_NAME to result.city) 
} 
forecastList.adapter = adapter 
toolbarTitle = "${result.city} (${result.country})" 
} 
} 


DetailActivity 也 需要 一 些 布局 上 的 修改 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: orientation="vertical"> 


<include layout="@layout/toolbar'"/> 


<LinearLayout 
android: layout_width="match_parent" 
android: layout_height="wrap_content" 
android: orientation="horizontal" 
android: gravity="center_vertical" 
android: paddingTop="@dimen/activity_vertical_margin" 
android: paddingLeft="@dimen/activity_horizontal_margin" 
android: paddingRight="@dimen/activity_horizontal_margin" 
tools:ignore="UseCompoundDrawables"> 


</LinearLayout> 


</LinearLayout> 


使 用 相同 的 方式 去 指定 toolbar 属 性 。 DetailActivity 也 会 初始 化 toolbar， 设 置 
title 并 且 开 局 导航 返回 icon : 


override fun oncreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) ; 
setContentView(R.layout.activity_detail) 


initToolbar() 
toolbarTitle = intent.getStringExtra(CITY_NAME) 
enableHomeAsUp { onBackPressed() } 


接口 可 以 帮助 我 们 从 类 中 提取 出 公共 的 代码 来 共享 相似 的 行为 。 可 以 作为 让 我 们 代 
码 精 炬 合理 简洁 可 复 用 的 替代 方案 。 思 考 哪 方面 接口 可 以 帮助 你 写 出 更 好 的 代码 。 


在 我 们 的 App 中 实现 一 个 例子 
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渤 型 
泛 型 编程 包括 ， 在 不 指定 代码 中 使 用 到 的 确切 类 型 的 情况 下 来 编写 算法 。 用 这 种 方 
式 ， 我 们 可 以 创建 函数 或 者 类 型 ， 唯 一 的 区 别 只 是 它们 使 用 的 类 型 不 同 ， 提 高 代码 
的 可 重用 性 。 这 种 代码 单元 就 是 我 们 所 知道 的 泛 型 ， 它 们 存在 于 很 多 的 语言 之 中 ， 
包括 Java 和 Kotlin。 


在 Kotlin 中 ， 泛 型 甚至 更 加 重要 ， 因 为 经 常 使 用 扩展 函数 将 会 成 倍增 加 我 们 泛 型 使 
用 频率 。 尽 管 我 们 已 经 在 本 书 中 盲目 地 使 用 了 泛 型 ， 但 是 泛 型 在 任何 语言 中 通常 都 
是 比较 困难 的 一 部 分 ， 所 以 我 尝试 使 用 尽 可 能 简单 的 方式 来 讲解 它 ， 这 样 主要 的 思 
想 也 会 足够 地 清晰 。 


基础 
举 个 例子 ， 我 们 可 以 创建 一 个 指定 泛 型 类 : 


class TypedClass<T>(parameter: T) { 
val value: T = parameter 


这 个 类 现在 可 以 使 用 任何 的 类 型 初始 化 ， 并 且 参 数 也 会 使 用 定义 的 类 型 ， 我 们 可 以 
这 么 做 : 


val t1 = TypedClass<String>("Hello World!") 
val t2 = TypedClass<Int>(25) 


但 是 Kotlin 很 简单 并 且 缩 减 了 模版 代码 ， 所 以 如 果 编 译 器 能 够 推断 参数 的 类 型 ， 我 
们 甚至 也 就 不 需要 去 指定 它 : 


val t1 = TypedClass("Hello World!") 
val t2 = TypedClass(25) 
val t3 = TypedClass<String?>(null) 
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断 出 来 。 


我 们 可 以 像 Java 中 那样 在 定义 中 指定 的 方式 来 增加 类 型 限制 。 比 如 ， 如 果 我 们 想 限 
制 上 一 个 类 中 为 非 null 类 型 ， 我 们 只 需要 这 么 做 : 


class TypedClass<T : Any>(parameter: T) { 
val value: T = parameter 


如 果 你 再 去 编译 前 面 的 代码 ， 你 将 看 到 t3 现在 会 抛 出 一 个 错误 。 可 null 类 型 不 再 
被 允许 了 。 但 是 限制 明显 可 以 更 加 严厉 。 如 果 我 们 只 希望 Context 的 子 类 该 怎么 
做 ?很 简单 : 


class TypedClass<T : Context>(parameter: T) { 
val value: T = parameter 


现在 所 有 继承 context 的 类 都 可 以 在 我 们 这 个 类 中 使 用 。 其 它 的 类 型 是 不 被 允许 
的 。 


当然 ， 可 以 使 用 函数 中 。 我 们 可 以 相当 简单 地 构建 泛 型 函数 : 


fun <T> typedFunction(item: 1): List<T> { 


FIA 


这 是 丨 的 是 最 难 理解 的 部 分 之 一 。 在 Java 中 ， 当 我 们 使 用 泛 型 的 时 候 会 出 现 问 题 。 
逻辑 告诉 我 们 List<String> 应 该 可 以 转型 为 List<0bject> ， 因 为 它 有 更 弱 的 
限制 。 但 是 我 们 来 看 下 这 个 例子 : 


List<String> strList = new ArrayList<>(); 
List<Object> objList = strList; 
objList.add(5); 

String str = objList.get(0); 


如 果 Java 编 译 器 允许 我 们 这 么 做 ， 我 们 可 以 增加 一 个 Integer 到 Object List’ 
但 是 它 明 显 会 在 某 一 时 刻 奔 溃 。 这 就 是 为 什么 语言 中 增加 了 通配符 。 通 配 符 可 以 在 
限制 这 个 问题 中 可 以 增加 灵活 性 。 


如 果 我 们 增加 了 ? extends Object ， 我 们 使 用 了 协 变 ( covariance ) >? CÀ 
示 我 们 可 以 处 理 任何 使 用 了 类 型 ， 比 Object 更 严格 的 对 象 ， 但 是 我 们 只 有 使 

用 get 操作 时 是 安全 的 。 如 果 我 们 想 去 拷贝 一 个 Strings 集合 到 objects 集合 
中 ， 我 们 应 该 是 允许 的 ， 对 吧 ? 然后 ， 如 果 我 们 这 样 


List<String> strList = ...; 
List<Object> objList = ...; 
objList.addAll(strList); 


这 样 是 可 以 的 ， 因 为 定义 在 Collection 接口 中 的 addAll() 是 这 样 的 : 


List<String> 
interface Collection<E> ... { 
void addAll(Collection<? extends E> items); 


否则 ， 没 有 通配符 ， 我 们 不 会 允许 在 这 个 方法 中 使 用 String Liste 相反 地 ， 当 然 
会 失败 。 我 们 不 能 使 用 addA11() 来 增加 一 个 Objects List 到 Strings List 
中 。 因 为 我 们 只 是 用 那个 方法 从 collection 中 获取 元 素 ， 这 是 一 个 完美 的 协 变 


( covariance ) 的 例子 


另 一 方面 ， 我 们 可 以 在 对 立 面 上 发 现 逆 变 ( contravariance ) 。 按 照 集 合 的 例 
子 ， 如 果 我 们 想 把 传 过 来 的 参数 增加 到 集合 中 去 ， 我 们 可 以 增加 更 加 限制 的 类 型 到 
泛 型 集合 中 。 比 如 ， 我 们 可 以 增加 Strings 到 Object List: 


void copyStrings(Collection<? super String> to, Collection<Strin 
g> from) { 
to.addAll(from) ; 


增加 Strings 到 另 一 个 集合 中 唯一 的 限制 就 是 那个 集合 接收 Strings RAR 
类 fo} 


但 是 通配符 都 有 它 的 限制 。 通 配 符 定义 了 使 用 场景 变 体 ( use-site 
variance ) ， 这 意味 着 当 我 们 使 用 它 的 时 候 需 要 声明 它 。 这 表示 每 次 我 们 声明 一 
乏 型 变量 时 都 会 增加 模版 代码 。 


让 我 们 看 一 个 例子 。 使 用 我 们 之 前 相似 的 类 : 


class TypedClass<T> { 
public T doSomething(){ 


这 些 代码 不 会 被 编译 : 


TypedClass<String> t1 = new TypedClass<>(); 
TypedClass<Object> t2 = t1; 


尽管 它 的 确 没有 意义 ， 因 为 我 们 仍然 保持 了 类 中 的 所 有 的 方法 并 且 没有 任何 损坏 。 
我 们 需要 指定 的 类 型 可 以 有 一 个 更 加 灵活 的 定义 。 


TypedClass<String> t1 = new TypedClass<>(); 
TypedClass<? extends String> t2 = t1; 


这 会 让 代码 更 加 难以 理解 ， 而 且 增 加 了 一 些 额外 的 模版 代码 。 


另 一 方面 ，Kotlin 通 过 内 部 声明 变 体 〈 declaration-site variance ) 可 以 使 用 
更 加 容易 的 方式 来 处 理 。 这 表示 当 我 们 定义 一 个 类 或 者 接口 的 时 候 我 们 可 以 处 理 弱 
限制 的 场景 ， 我 们 可 以 在 其 它 地 方 直接 使 用 它 。 


所 以 让 我 们 看 看 它 在 Kotlin 中 是 怎么 工作 的 。 相 比 元 长 的 通配符 ，Kotlin 仅 仅 使 

用 out 来 针对 协 变 ( covariance ) 和 使 用 in 来 针对 逆 变 

( contravariance ) 。 在 这 个 例子 中 ， 当 我 们 类 产生 的 对 象 可 以 被 保存 到 弱 限 
的 变量 中 ， 我 们 使 用 协 变 。 我 们 可 以 直接 在 类 中 定义 声明 { 


class TypedClass<out T>() { 
fun doSomething(): T { 


er 需要 的 。 现 在 ， 在 Java 中 不 能 编译 的 代码 在 Kotlin 中 可 以 完美 运 


ra 


val t1 = TypedClass<String>() 
val t2: TypedClass<Any> = t1 


如 果 你 已 经 使 用 了 这 些 概念 ， 我 确信 你 可 以 很 简单 地 在 Kotlin 使 用 in 和 out ° F 
则 ， 你 也 只 是 需要 一 些 联系 和 概念 上 的 理解 。 


泛 型 例子 


理论 之 后 ， 我 们 转移 到 一 些 实际 功能 上 面 ， 这 会 让 我 们 更 加 简单 地 掌握 它 。 为 了 不 
重复 发 明 轮 予 ， 我 使 用 三 个 Kotlin 标 准 库 中 的 三 个 函数 。 这 些 函 数 让 我 们 仅 使 用 泛 
型 的 实现 就 可 以 做 一 些 很 棒 的 事情 。 它 可 以 鼓舞 你 创建 自己 的 函数 。 

let 


let 实在 是 一 个 简单 的 函数 ， 它 可 以 被 任何 对 象 调 用 。 它 接收 一 个 函数 (接收 一 
个 对 象 ， 返 回 函数 结果 ) 作为 参数 ， 作 为 参数 的 函数 返回 的 结果 作为 整个 函数 的 返 
回 值 。 它 在 处 理 可 null 对 象 的 时 候 是 非常 有 用 的 ， 下 面 是 它 的 定义 : 


indjane tun-<i, RUTEIGELT (1) == Rk): R= f(this) 
它 使 用 了 两 个 泛 型 类 型 : T 和 R 。 第 一 个 是 被 调用 者 定义 的 ， 它 的 类 型 被 函数 
接收 到 。 第 二 个 是 函数 的 返回 值 类 型 。 


我 们 怎么 去 使 用 它 呢 ?你 可 能 还 记得 当 我 们 从 数据 源 中 获取 数据 时 ， 结 果 可 能 是 
null。 如 果 不 是 null， 则 把 结果 映射 到 domain model 并 返回 结果 ， 否 则 直接 返回 
null : 


if (forecast != null) dataMapper.convertDayToDomain(forecast) el 
se null 


这 代码 是 非常 焉 陋 的 ， 我 们 不 需要 使 用 这 种 方式 去 处 理 可 hull 对 象 。 实 际 上 如 果 我 
们 使 用 let ， 都 不 需要 if 


forecast?.let { dataMapper.convertDayToDomain(it) } 


SG 2. REF’ let BRARAZE forecast 不 是 null 的 时 候 才 会 执行 。 否 则 它 
会 返回 null。 也 就 是 我 们 想 达 到 的 效果 。 


With 


函数 会 作为 


o 


人 
这 个 对 象 的 扩展 函数 执行 。 这 表示 我 们 根据 推断 可 以 在 函数 内 使 用 this 


inline fun <T, R> with(receiver: T, f: T.() -> R): R = receiver.f 


() 
= J» 





图 


泛 型 在 这 里 也 是 以 相同 的 方式 运行 : T 代表 接收 类 型 ， R 代表 结果 。 如 你 所 见 
函数 通过 fF: T.() -> R (oe, mene 就 是 为 什么 我 们 可 以 调 
用 


fe} 


receiver.f() 
通过 这 个 app， 我 们 有 几 个 例子 : 


fun convertFromDomain(forecast: ForecastList) = with(forecast) { 
it) 


val daily = dailyForecast map { convertDayFromDomain(id, 


CityForecast(id, city, country, daily) 


apply 
它 看 起 来 于 with 很 相似 ， 但 是 是 有 点 不 同 之 处 。 apply 可 以 避免 创建 builder 的 
方式 来 使 用 ， 因 为 对 象 调 用 的 函数 可 以 根据 自己 的 需要 来 初始 化 自己 ， 然 


后 apply 函数 会 返回 它 同一 个 对 象 : 


inline tun <i> Teapply(f: 1.0) == Unit): if TC): return this } 


这 里 我 们 只 需要 一 个 泛 型 类 型 ， 因 为 调用 这 个 函数 的 对 象 也 就 是 这 个 函数 返回 的 对 


象 。 一 个 不 错 的 例子 


val textView = TextView(context).apply { 


text = "Hello" 
hint = "Hint" 
textColor = android.R.color.white 


它 创 建 了 一 个 TextView ， 修 改 了 一 些 属性 ， 然 后 赋值 给 一 个 变量 。 一 切 都 很 简 
单 ， 具 有 可 读 性 和 坚 国 的 语法 。 让 我 们 用 在 当前 的 代码 中 。 
在 ToolbarManager 中 ， 我 们 使 用 这 种 方式 来 创建 导航 drawable : 


private fun createUpDrawable() = with(DrawerArrowDrawable(toolba 


CEX) es 
progress = 1f 
this 

} 


使 用 with 和 返回 this 是 非常 清晰 的 ， 但 是 使 用 apply 可 以 更 加 简单 : 


private fun createUpDrawable() = DrawerArrowDrawable(toolbar.ctx) 


-apply { 
progress = 1f 


[| 


你 可 以 在 Kotlin for Android Developer 代码 库 中 查看 这 些小 的 优化 。 


设置 界面 


直到 现在 ， 我 们 都 是 使 用 的 默认 的 城市 来 实现 这 个 app， 但 是 现在 是 时 候 增 加 一 个 
选择 城市 的 功能 了 。 我 们 的 App 需 要 一 个 设置 栏 来 让 用 户 修改 城市 。 


我 们 使 用 zip code (MA) 来 区 分 城市 。 一 个 真正 的 App 可 能 需要 更 多 的 信息 ， 

因为 只 有 邮编 在 整个 世界 中 可 能 无 法 作为 辨认 依据 。 但 是 我 们 至 少 会 显示 在 设置 中 
使 用 zip code 定义 的 世界 上 的 城市 。 这 会 是 一 个 用 来 解释 怎么 使 用 有 趣 的 方式 处 
理 preferences 的 例子 。 


创建 一 个 设置 activity 


当 toolbar 上 溢出 菜单 〈 overflow menu ) 的 settings 选项 被 点 击 时 ， 需 要 打开 
一 个 新 的 Activity。 所 以 首先 要 做 的 事情 时 需要 一 个 新 的 SettingActivity 


class SettingsActivity : AppCompatActivity() { 


override fun onCreate(savediInstanceState: Bundle?) { 
super .onCreate(savedInstanceState ) 
setContentView(R.layout.activity_settings) 
setSupportActionBar (toolbar) 
supportActionBar .setDisplayHomeAsUpEnabled( true) 


override fun onOptionsItemSelected(item: MenuItem) = when (i 
tem.itemId) { 
android.R.id.home -> { onBackPressed(); true } 
else -> false 


当 用 户 离开 这 个 界面 的 时 我 们 需要 保存 用 户 preference (偏好 ) ， 所 以 我 们 需 
BARRE Back 一 样 处 理 Up 动作 ， 重 定向 动作 到 onBackPressed 。 现 在 ， 让 我 
们 要 创建 一 个 XML 布局 。 对 于 这 个 preference 来 说 一 个 简单 EditText 就 足够 
73 


创建 一 个 设置 activity 


<FrameLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


android: layout_width="match_parent" 


android: layout_height="match_parent"> 


<include layout="@layout/toolbar"/> 


<LinearLayout 


android: orientation="vertical" 


android: layout_width="match_parent" 


android: layout_height="match_parent" 


android: layout_marginTop="?attr/actionBarSize" 


android: padding="@dimen/spacing_xlarge"> 


<TextView 


android: 
android: 
android: 


<EditText 


android: 
android: 
android: 
android: 
android: 


</LinearLayout> 
</FrameLayout> 


layout_width="wrap_content" 
layout_height="wrap_content" 
text="@string/city_zipcode"/> 


id="@+id/cityCode" 
layout_width="match_parent" 
layout_height="wrap_content" 
hint="@string/city_zipcode" 
inputType="number"/> 


然后 只 需要 在 AndroidManifest.xml ¥ Æ 2% “activity : 


<activity 


android: name=".ui.activities.SettingsActivity" 


android: label="@string/settings"/> 


192 


仿 问 Shared Preferences 


你 可 道 什么 是 Android Shared Preferences。 可 以 通过 Android 框 架 简 单 存储 的 
ss 这 些 preferences 与 SDK 的 一 部 分 融 为 一 体 ， 使 得 任务 变 
得 更 加 容易 。 而 且 从 Android 6.0 (Marshmallow) > shared preferences 可 以 
自动 被 云 存储 ， 所 以 当 一 个 用 户 在 一 个 新 的 设备 上 面 恢 复 App 的 时 候 ， 它 们 

的 preferences 也 会 被 恢复 。 


多 亏 使 用 了 属性 委托 ， 我 们 可 以 使 用 非常 简单 的 方式 来 处 理 preferences ° RM 
可 以 创建 一 个 委托 ， 当 get 被 调用 时 去 查询 ， 当 set 被 调用 时 去 执行 保存 操作 。 


因为 我 们 想 去 保存 zip code ， 它 是 一 个 long 型 ， 所 以 让 我 们 创建 一 个 Long 属 性 
的 委托 吧 。 在 DelegatesExtensions.kt 中 ， 实 现 一 个 新 
的 LongPreference 类 : 


class LongPreference(val context: Context, val name: String, val 
default: Long) 
ReadwriteProperty<Any?, Long> { 


val prefs by lazy { 
context.getSharedPreferences(“default", Context .MODE_PRI 
VATE) 


} 


override fun getValue(thisRef: Any?, property: KProperty<*>) 
Long 4 
return prefs.getLong(name, default) 


override fun setValue(thisRef: Any?, property: KProperty<*>, 
value: Long) { 
prefs.edit().putLong(name, value) .apply() 


， 我 们 使 用 es) 委托 的 方式 创建 一 个 preferences。 这 样 的 话 ， 如 果 我 们 没 
Hoa 文 个 属性 ， 委托 就 不 会 请 求 这 个 SharedPreferences 对 象 。 


当 get 被 调用 ， 它 的 实现 是 使 用 preferences 实 例 去 获取 一 个 委托 声明 中 指定 名 字 
的 long 属 性 ， 如 果 没 有 找到 这 个 属性 ， 则 默认 使 用 default。 当 一 个 值 被 set > Z 
到 preferences editor 并 使 用 属性 名 保存 。 


我 们 可 以 在 DelegatesExt 中 定义 一 个 新 的 委托 ， 这 样 我 们 访问 时 就 简单 很 多 : 
object DelegatesExt { 
fun longPreference(context: Context, name: String, default: 


Long) = 
LongPreference(context, name, default) 


在 SettingActivity ， 现 在 可 以 定义 一 个 属性 去 处 理 zip code 偏好 。 我 创建 了 
两 个 常量 用 来 作为 名 字 和 属性 的 默认 值 。 这 种 方式 可 以 在 App 其 他 地 方 使 用 : 


companion object { 
val ZIP_CODE = "zipCode" 
val DEFAULT_ZIP = 94043L 


var zipCode: Long by DelegatesExt.longPreference(this, ZIP_CODE, 
DEFAULT_ZIP) 


现在 preference 工 作 起 来 就 非常 简单 了 ， 我 们 可 以 从 属性 中 得 到 并 赋值 
给 EditText 


override fun oncreate(savedInstanceState: Bundle?) { 


cityCode.setText(zipCode.toString()) 


我 们 不 能 使 用 自动 生成 的 属性 text > AW EditText 在 getText 中 返回 的 
是 Editable ， 所 以 该 属性 默认 为 该 值 。 如 果 我 尝试 去 分 配 一 个 String ， 编 译 
器 会 报错 ， 使 用 setText() 就 足够 了 。 


现在 具备 了 所 有 要 实现 onBackPressed 的 东西 。 这 里 ， 一 个 属性 的 新 值 会 被 储 
存 : 


override fun onBackPressed() { 
super .onBackPressed( ) 
ZipCode = cityCode.text.toString().toLong() 


MainActivity 需要 一 些小 的 改变 。 首 先 ， 它 也 需要 一 个 zip code 属性 。 


val zipCode: Long by DelegatesExt.longPreference(this, SettingsA 
ctivity.ZIP_CODE, 
SettingsActivity.DEFAULT_ZIP) 


然后 ， 我 把 forecast load 的 代码 移动 到 了 onResume ， 这 样 每 次 activity 
resumed， 它 都 会 刷新 数据 ， 以 防 code zip 被 修改 。 当 然 这 里 有 更 加 复杂 一 点 的 
方式 去 做 ， 比 如 通过 在 请 求 forecast 之 前 检查 是 否 zip code AFT BER 
像 保持 这 个 例子 的 简单 性 ， 而 且 因 为 请 求 的 数据 已 经 保存 在 本 地 数据 库 中 了 ， 所 以 
这 个 解决 方案 也 不 萌 太 坏 : 


override fun onResume() { 
super .onResume() 
loadForecast() 


private fun loadForecast() = async { 
val result = RequestForecastCommand(zipCode).execute() 
uiThread { 
val adapter = ForecastListAdapter(result) { 
startActivity<DetailActivity>(DetailActivity.ID to i 


tid, 
DetailActivity.CITY_NAME to result.city) 
} 
forecastList.adapter = adapter 
toolbarTitle = "${result.city} (${result.country})" 
} 


RequestForecastCommand 现在 使 用 zipCode 而 不 是 之 前 的 是 一 个 固定 值 。 


这 里 还 有 意见 我 们 必须 要 做 的 事情 : 当 溢 出 菜单 的 settings 点 击 时 启动 这 
个 setting activity 。 在 ToolbarManager 中 的 initToolbar 函数 需要 有 一 
些小 的 修改 : 


when (it.itemiId) { 

R.id.action_settings -> toolbar.ctx.startActivity<SettingsAc 
tivity>() 

else -> App.instance.toast("Unknown option") 


iz M preference $46 


现在 我 们 已 经 是 泛 型 专家 了 ， 为 什么 不 扩展 LongPreference 为 支持 所 有 Shared 
Preferences 支持 的 类 型 呢 ? 我 们 来 创建 一 个 Preference 委托 : 


class Preference<T>(val context: Context, val name: String, val 
default: T) 
: ReadWriteProperty<Any?, T> { 


val prefs by lazy { 
context.getSharedPreferences("default", Context .MODE PRI 
VATE) 


i 


override fun getValue(thisRef: Any?, property: KProperty<*>) 
= y 


return findPreference(name, default) 


override fun setValue(thisRef: Any?, property: KProperty<*>, 
value: T) { 
putPreference(name, value) 


这 个 preference 与 我 们 之 前 使 用 的 非常 相似 。 我 们 仅仅 替换 了 Long 为 泛 型 类 
AT ， 然 后 调用 了 两 个 函数 来 做 具体 重要 的 工作 。 这 些 函 数 非 常 简单 ， 尽 管 有 些 
重复 。 它 们 会 检查 类 型 然后 使 用 指定 的 方式 来 操作 。 比 如 ， findPrefernce 3 
如 下 : 


private fun <T> findPreference(name: String, default: T): T = wi 
th(prefs) { 

val res: Any = when (default) { 

is Long -> getLong(name, default) 

is String -> getString(name, default) 

is Int -> getInt(name, default) 

is Boolean -> getBoolean(name, default) 

is Float -> getFloat(name, default) 

else -> throw IllegalArgumentException( 

"This type can be saved into Preferences") 


res as T 


putPreference 函数 也 是 一 样 ， 但 是 在 when 最 后 通过 apply ， 使 
用 preferences editor 保存 结果 : 


private fun <U> putPreference(name: String, value: U) = with(pre 
fs.edit()) { 
when (value) { 
is Long -> putLong(name, value) 
is String -> putString(name, value) 
is Int -> putInt(name, value) 
is Boolean -> putBoolean(name, value) 
is Float -> putFloat(name, value) 
else -> throw IllegalArgumentException("This type can be 
saved into Pref\ 
erences") 


}-apply() 


现在 修改 DelegateExt 


object DelegatesExt { 


fun preference<T : Any>(context: Context, name: String, defa 
We) 
= Preference(context, name, default) 


这 章 之 后 ， 用 户 可 以 访问 设置 界面 并 修改 zip code 。 然 后 当 我 们 返回 主 界面 ， 
forecast 会 自动 重新 刷新 并 显示 新 的 信息 。 查 看 代码 库 中 其 余 xi wei 


测试 你 的 App 


我 们 即将 到 达 这 次 旅程 的 结尾 。 通 过 本 书 你 已 经 学 习 了 大 部 分 Kotlin 的 知识 ， 但 是 
你 可 能 会 怀疑 你 是 否 可 以 测试 你 只 用 Kotlin 编 写 的 Android App 呢 ? 回答 是 : 当然 ! 


在 Android 中 我 们 有 两 种 不 同 的 测试 : unit test 和 instrumentation test 。 
很 明 pelo 么 去 测试 的 ， 有 很 多 专门 为 此 写 的 书 。 我 在 这 一 章 的 目标 
是 怎么 去 搭建 你 测试 环境 ， 展 示 给 你 看 Kotlin 在 测试 方面 也 能 很 好 的 工作 。 


Unit testing 


我 不 会 对 unit testing (单元 测试 ) 是 什么 的 话题 展开 讨论 。 存 在 很 多 定义 ， 
但 是 都 有 一 些 细微 的 不 同 。 一 个 普通 的 观点 可 能 是 unit testing 验证 一 个 单位 
( unit ) 的 源 代码 的 测试 。 一 个 单位 〈 unit ) 包含 什么 就 留 给 读者 了 。 在 我 
SE RT ee ee eT 
IDE 将 会 运行 这 些 测试 然后 显示 最 后 的 结果 分 辩 哪 些 测试 成 功 哪些 测试 失败 了 。 


Unit testing 通常 使 用 JUnit 库 。 所 以 让 我 们 增加 这 个 依赖 

到 build.gradle 。 因 为 这 个 依赖 只 会 在 跑 测试 的 时 候 才 会 用 到 ， 所 以 我 们 可 以 
使 用 testCompile 而 不 是 compile 。 用 这 种 方式 ， 这 个 库 会 在 正式 编译 时 忽略 
掉 ， 可 以 减少 APK 的 大 小 : 


dependencies { 


testCompile 'junit:junit:4.12' 


现在 同步 gradle 来 获取 该 库 并 加 入 到 你 的 项 目 中 。 为 了 开启 unit testing ， 打 
J Build Variants tab (你 可 能 可 以 在 IDE 的 左边 找到 它 ) ， 点 击 Test 
Artifact 下 拉 ， 你 应 该 选择 Unit Tests ° 


另 一 件 你 需要 做 的 事情 是 创建 一 个 新 的 文件 夹 。 在 src 下 面 ， 你 可 能 已 经 

有 androidTest 和 main 了 。 创 建 另 一 个 名 为 test 的 文件 夹 ， 再 在 它 下 面 创建 
一 个 java 文件 夹 。 所 以 现在 你 应 该 有 一 个 名 为 src/test/java REN LHS ° 
这 是 IDE 发 现 我 们 在 使 用 Unit Test 模式 好 的 迹象 ， 这 个 文件 夹 中 将 会 包括 一 些 

测试 文件 。 


我 们 来 写 一 个 非常 简单 的 测试 来 看 看 一 切 是 不 是 正常 运行 了 。 使 用 合适 的 包 名 (我 
的 是 com.antonioleiva.weatherapp ， 但 是 你 需要 使 用 你 app 中 的 主 包 名 ) 创建 
一 个 新 的 名 为 SimpleTest 的 Kotlin 类 。 当 你 创建 完 ， 编 写 如 下 简单 的 测试 : 


import org.junit.Test 
import kotlin.test.assertTrue 
class SimpleTest { 
@Test fun unitTestingWorks() { 
assertTrue(true) 


使 用 @Test 注解 来 辨别 该 函数 为 是 一 个 测试 。 确 认 是 org.unit.Test 。 然 后 增 
加 一 个 简单 的 断言 。 它 只 是 判断 了 true 是 否 是 true， 它 显然 会 成 功 。 这 个 测试 只 是 
用 开 确 认 一 切 配 置 正确 。 


执行 测试 ， 只 需要 在 你 在 test 下 创建 的 新 的 java 文件 夹 上 右 击 ， 然 后 
择 Run All Tests 。 当 编译 完成 后 ， 它 会 运行 测试 并 会 看 见 结 果 简 人 er 。 你 
应 该 可 以 看 见 我 们 的 测试 通过 了 


现在 是 时 候 创建 一 个 丨 正 的 测试 了 。 所 有 使 用 Android 框 架 来 处 理 的 测试 可 能 都 需 
要 一 个 instrumentation test 或 者 使 用 更 复杂 的 像 Robolectric 库 。 所 以 在 这 些 
例子 中 我 会 不 使 用 框架 的 任何 东西 。 举 个 例子 ， 我 将 测试 从 Long 转 String 的 
扩展 函数 。 


创建 一 个 新 的 名 为 ExtensionTests 的 文件 ， 然 后 增加 如 下 测试 : 


class ExtensionsTest { 


@Test fun testLongToDateString() { 
assertEquals("Oct 19, 2015", 1445275635000L.toDateString 


()) 


@Test fun testDateStringFullFormat() { 
assertEquals("Monday, October 19, 2015", 
1445275635000L.toDateString(DateFormat .FULL) ) 


这 些 测试 检测 Long 实例 是 否 可 以 转换 成 一 个 String 。 第 一 个 测试 默认 行为 
(48 Fl DateFormat MEDIUM)) 而 第 二 个 指定 一 个 不 同 的 格式 。 运 行 这 些 测试 然 
后 你 会 看 到 它们 都 通过 了 。 我 建议 你 修改 它们 然后 看 看 它们 失败 是 怎么 样 的 。 


你 在 Java 中 使 用 过 测试 ， 你 将 会 发 现 这 并 没有 什么 太 多 的 不 同 。 我 会 演示 一 个 
pes 我 们 可 以 对 ForecastProvider 进行 一 些 测 试 。 我 们 可 以 使 
用 Mockito 库 来 模拟 其 它 的 类 然后 独立 测试 provider : 


dependencies { 


testCompile "junit: junit:4.12" 
testCompile "org.mockito:mockito-core:1.10.19" 


现在 创建 了 一 个 ForecastProvidertest 。 我 们 要 去 测试 ForecastProvider ， 
使 用 DataSource 来 返回 结果 ， 看 它 结果 是 否 为 null。 所 以 首先 我 们 需要 模拟 一 


个 ForecastDataSource 


val ds = mock(ForecastDataSource::class. java) 
‘when (ds.requestDayForecast(0)).then { 
Forecast(0, ©, “desc”, 20, ©, Url ) 


如 你 所 见 ， 我 们 需要 在 when 上 加 反 引 号 。 因 为 when 在 Kotlin 中 是 一 个 保留 关键 
字 ， 所 以 如 果 我 们 在 一 些 Java 代 码 中 使 用 到 它 我 们 需要 避免 它 。 现 在 我 们 用 这 个 数 
据 源 创建 了 一 个 provider， 然 后 检测 调用 那个 方法 之 后 的 结果 是 否 为 null : 


val provider = ForecastProvider(listOf(ds) ) 
assertNotNull(provider.requestForecast(Q0) ) 


@Test fun testDataSourceReturnsValue() { 
val ds = mock(ForecastDataSource::class. java) 
“when~(ds.requestDayForecast(0)).then { 
Forecast(0, ©, "desc", 20, ©, "url") 


val provider = ForecastProvider(listOf(ds) ) 
assertNotNull(provider.requestForecast (0) ) 


如 果 你 运行 它 ， 你 将 会 看 见 它 会 出 错 。 多 亏 这 个 测试 ， 我 们 在 自己 的 代码 中 发 现 了 
某 些 错误 。 测 试 失败 是 因为 ForecastProvider 在 使 用 之 前 正在 它 的 companion 
object 中 初始 化 。 我 们 可 以 通过 构造 函数 的 方式 在 ForecastProvider 中 增加 一 
些 数据 源 ， 这 个 静态 的 List 就 永远 不 会 被 使 用 ， 所 以 它 应 该 是 使 用 lazy 加 载 : 


companion object { 
val DAY_IN OMELLIS = 1000 * 60° * 60 * 24 
val SOURCES by lazy { listOf(ForecastDb(), ForecastServer()) 


如 果 你 现在 再 次 去 运行 ， 你 会 发 现 现在 会 通过 所 有 的 测试 。 我 们 也 可 以 测试 一 些 比 
如 当 数 据 源 返 回 null 的 时 候 ， 它 会 便利 下 一 个 数据 源 来 得 到 结果 : 


@Test fun emptyDatabaseReturnsServerValue() { 
val db = mock(ForecastDataSource::class.java) 
val server = mock(ForecastDataSource::class.java) 
when (server. requestForecastByZipCode( 
any(Long::class.java), any(Long::class.java))) 
‘then { 
ForecastList(0, "city", "country", listOf()) 
val provider = ForecastProvider(listOf(db, server) ) 
assertNotNull(provider.requestByZipCode(9, 0)) 


如 你 所 见 ， 通 过 使 用 参数 的 默认 值 这 种 简单 的 依赖 倒置 足够 让 我 们 实现 一 些 简单 
的 unit tests 。 对 于 这 个 provider 还 有 很 多 我 们 可 以 测试 的 东西 ， 但 是 这 个 例子 
足够 让 我 们 学 会 使 用 unit testing 工具 了 。 


Instrumentation tests 


Instrumentation tests 有 一 点 不 同 。 它 们 通常 被 使 用 在 Ul 交互 上 ， 我 们 需要 一 
个 应 用 程序 实例 跑 的 同时 执行 测试 。 达 到 这 个 ， 我 们 就 需要 在 设备 上 部 署 并 运行 


这 类 的 测试 必须 要 放 在 androidTest 文件 夹 中 ， 我 们 必须 要 修改 Build 
Variants 区 域 的 Test Artifact A Android Instrumentation Tests 。 实 现 
instrumentation 的 官方 库 是 Espresso， 它 通过 Actions `œ filter 以 及 检测 结果 
的 ViewMatchers 和 Matchers 可 以 帮助 我 们 更 简单 地 使 用 。 


配置 比 之 前 更 加 难 一 点 。 我 们 需要 下 载 额 nies Gradle 的 配置 。 好 事 是 Kotlin 
的 测试 不 需要 添加 额外 的 东西 ， 所 以 如 果 你 已 经 知道 怎么 去 配置 Espresso ， 它 将 
对 你 来 说 是 很 简单 的 。 


首先 ， 在 defaultConfig 中 指定 test runner 
defaultConfig { 


testInstrumentationRunner "android.support.test.runner.Andro 
idJUnitRunner" 


} 


当 你 处 理 完 该 runner， 然 后 增加 其 它 的 依赖 ， 这 次 是 用 androidTestCompile ° 
这 种 方式 ， 这 些 库 只 会 再 编译 运行 instrumentation tests 的 时 候 才 被 增加 : 


dependencies { 


androidTestCompile "com.android.support:support-annotations: 
$support_version" 

androidTestCompile "com.android.support.test:runner:0.4.1" 

androidTestCompile "com.android.support.test:rules:0.4.1" 

androidTestCompile "com.android.support.test.espresso:espres 
SO-COre:2.2.1" 

androidTestCompile ("com.android.support.test.espresso:espre 
sso-contrib:2.2.1")¢ 

exclude group: 'com.android.support', module: 'appcompat' 


exclude group: 'com.android.support', module: 'support-v 


exclude module: 'recyclerview-v7' 


4 ee ol 
我 不 想 花 大 量 的 时 间 去 讲 这 些 ， 但 是 这 里 有 为 什么 需要 这 些 库 的 简短 原因 : 


e support-annotations : 其它 库 中 需要 使 用 到 。 

e runner :这 是 test runner ， 就 是 我 们 再 defaultConfig 中 指定 的 那 

e rules : 包括 一 些 测试 inflate 启 动 activity 的 规则 。 我 们 将 会 在 我 们 的 例子 中 
使 用 这 些 规 则 。 

e espresso-core : Espresso 的 基本 实现 ， 它 让 instrument tests 更 加 
BH ° 

e espresso-contrib : 它 增加 了 其 它 额外 的 功能 ， 比 如 支 
持 RecyclerView 测试 。 我 们 不 得 不 排除 掉 一 些 它 的 依赖 ， 因 为 我 们 已 经 在 
这 个 项 目 中 使 用 到 了 ， 否 则 测试 会 出 错 。 


我 们 现在 来 创建 一 个 简单 的 例子 。 测 试 将 会 点 击 forecast 列 表 的 第 一 行 ， 然 后 它 会 
判断 是 否 能 找到 一 个 id 为 R.id.weatherDescription 的 view。 这 个 view 是 

在 DetailActivity 中 的 ， 这 表示 我 们 在 测试 在 RecyclerView 里 面 点 击 后 是 否 可 
以 成 功 地 导航 到 详情 页 面 。 


class SimpleInstrumentationTest { 


@get:Rule 
val activityRule = ActivityTestRule(MainActivity: :class.java) 


} 
= = a 


4] 





首先 我 们 需要 指定 它 运 行 时 使 用 AndroidJUnit4 。 然 后 ， 创 建 一 个 activity 规 则 ， 
它 会 实例 化 一 个 测试 需要 的 activity。 在 Java 中 ， 你 可 以 使 用 @Rule 。 但 是 如 你 所 
知 ， 字 段 和 属性 是 不 一 样 的 ， 所 以 如 果 你 像 那样 去 使 用 的 话 ， 执 行 会 失败 因为 访问 
ee 你 需要 加 注解 的 是 在 getter 上 面 。Kotlin 允 许 指 

定 get 或 者 set 在 Rule 的 名 字 前 面 。 在 这 个 例子 中 ， 只 要 些 @get:Rule 。 


之 后 ， 我 们 已 经 准备 好 创建 第 一 个 测试 了 : 


@Test fun itemClick_navigatesToDetail() { 
onView(withId(R.id.forecastList) ).perform( 


RecyclerViewActions 
.actionOnItemAtPosition<RecyclerView.ViewHolder>( 


©, click())) 
onView(withId(R.id.weatherDescription) ) 
.check(matches(isAssignableFrom(TextView: :class. java) 


| 


函数 加 上 了 @Test 注解 ， 这 根 我 们 使 用 unit test 的 方式 一 样 。 我 们 可 以 开始 
在 测试 体 中 使 用 Espresso ° © AA RecyclerView 的 第 一 个 position 中 执行 了 
一 个 点 击 。 然 后 它 检测 是 否 可 以 找到 一 个 指定 id 的 view 且 这 个 view 是 一 


个 TextView 。 


要 运行 这 个 测试 ， 点 击 顶部 的 Run configurations 下 拉 选 择 Edit 
Configurations... F + 图 标 ， 选 择 Android Tests ， 然 后 选择 ef 模 
块 。 现 在 ， 在 target device 中 选择 你 喜欢 的 target 。 点 击 OK 然后 运 


应 该 可 以 看 到 App 是 怎样 在 你 的 设备 中 开始 的 ， 它 会 测试 第 一 个 position， 打 开 详 情 
页 面 然后 再 次 关闭 app。 


现在 我 们 要 做 一 个 更 加 复杂 一 点 的 事情 。 测 试 会 从 toolbar 众 打开 一 个 溢出 菜单 ， 点 
击 settings 栏 ， 改 变 城市 的 code ， 然 后 检测 toolbar 的 标题 是 否 改变 成 了 对 应 
的 标题 。 


@Test fun modifyZipCode_changesToolbarTitle() { 
A Ove lo Ot Me i atiy) 
onView(withText(R.string.settings)).perform(click()) 
onView(withId(R.id.cityCode) ).perform(replaceText("28830") ) 
pressBack() 
onView(isAssignableFrom(Toolbar::class.java)) 
.check(matches( 
withToolbarTitle( is ("San Fernando de Henares ( 


ES)")))) 
} 


之 个 测试 实际 做 的 事情 


e 它 首 先 使 用 openActionBarOverflowO0rOptionsMenu 打开 溢出 菜单 。 

e 然后 它 根 据 Settings 文本 查找 一 个 view， 然 后 点 击 这 个 它 。 

o 之后， 设置 界面 就 会 被 打开 ， 所 以 它 会 查找 一 个 EditText 并 且 替 换 成 一 个 新 
的 code 。 

e 它 会 点 击 返回 按钮 。 它 会 把 新 的 值 保 存在 preferences 中 ， 然 后 关闭 Activity 。 

e 因为 MainActivity 的 onResume 会 调用 ， 请 求 会 再 调用 一 次 。 这 时 它 会 获 
取 到 新 城市 的 forecast ° 

e 最 后 一 行将 会 检测 Toolbar 我 们 看 到 的 title 是 否 是 新 的 城市 的 title © 


这 不 是 一 个 toolbar 的 title 的 默认 匹配 器 ， 但 是 Espresso 是 很 容易 扩展 的 ， 所 以 我 
们 可 以 创建 一 个 新 的 matcher 来 实现 检测 : 


private fun withToolbarTitle(textMatcher: Matcher<CharSequence>) 
: Matcher<Any> = 


object : BoundedMatcher<Any, Toolbar>(Toolbar::class. java 


) {í 
override fun matchesSafely(toolbar: Toolbar): Boolean { 
return textMatcher .matches(toolbar.title) 
} 
override fun describeTo(description: Description) { 
description.appendText("with toolbar title: ") 
textMatcher.describeTo(description) 
} 
} 


国 守 一 z= 


matchSafely 远 数 是 我 们 检测 的 地 方 ， 而 describeTo 4A matcher3¥ ze f — 
些 新 的 信息 。 


这 章 特别 有 趣 ， 因 为 我 们 看 到 了 在 Kotlin 中 怎么 样 去 完美 和 谐 地 整合 测试 ， 它 们 可 
以 没有 任何 问题 地 整合 测试 。 查 看 代码 然后 你 自己 运行 一 下 吧 。 


其 它 的 概念 


通过 本 书 ， 我 们 讲解 了 Koltin 语 言 中 大 部 分 的 概念 。 但 是 其 中 茶 一 些 我 们 在 这 个 App 
中 没有 使 用 到 ， 我 会 把 它们 放 到 这 章 中 来 。 这 章 中 ， 我 们 回顾 一 些 无 关 的 内 容 ， 以 
便 你 在 你 自己 的 Kotlin 项 目 中 可 以 使 用 到 它们 。 


在 Java 中 ， 我 们 可 以 在 类 的 里 面 再 定义 类 。 如 果 它 是 一 个 通常 的 类 ， 它 不 能 去 访问 
外 部 类 的 成 员 (就 如 Java 中 的 static ) 


class Outer { 
private val bar: Int = 1 
class Nested { 
fun foo() = 2 


val demo = Outer.Nested().foo() // == 2 


如 果 需 要 去 访问 外 部 类 的 成 员 ， 我 们 需要 用 inner 声明 这 个 类 : 


class Outer { 
private val bar: Int = 1 
inner class Innerf{ 
fun foo() = bar 


val demo = Outer().Inner().foo() // == 1 


枚 举 
Kotlin 也 提供 了 枚 举 ( enums ) 的 实现 : 


enum class Day { 
SUNDAY, MONDAY, TUESDAY, WEDNESDAY, 
THURSDAY, FRIDAY, SATURDAY 


枚 举 可 以 带 有 参数 : 


enum class Icon(val res: Int) { 
UP(R.drawable.ic_up), 
SEARCH(R.drawable.ic_search), 
CAST(R.drawable.ic_cast) 


val searchIconRes = Icon.SEARCH.res 


枚 举 可 以 通过 String 匹配 名 字 来 获取 ， 我 们 也 可 以 获取 包含 所 有 枚 举 
的 Array ， 所 以 我 们 可 以 遍历 它 。 


val search: Icon = Icon.valueOf ("SEARCH") 
val iconList: Array<Icon> = Icon.values() 


而 且 每 一 个 枚 举 都 有 一 些 函数 来 获取 它 的 名 字 、 声 明 的 位 置 : 


val searchName: String = Icon.SEARCH ,name'( ) 
val searchPosition: Int = Icon.SEARCH.ordinal() 


枚 举 根据 它 的 顺序 实现 了 Comparable 接口 ， 所 以 可 以 很 方便 地 把 它们 进 
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密封 (Sealed) 类 


密封 类 用 来 限制 类 的 继承 关系 ， 这 意味 着 密封 类 的 子 类 数量 是 固定 的 。 看 起 来 就 像 
是 枚 举 那样 ， 当 你 想 在 一 个 密封 类 的 子 类 中 寻找 一 个 指定 的 类 的 时 候 ， 你 可 以 事先 
知道 所 有 的 子 类 。 不 同 之 处 在 于 枚 举 的 实例 是 唯一 的 ， 而 密封 类 可 以 有 很 多 实例 ， 
它们 可 以 有 不 同 的 状态 。 


我 们 可 以 实现 ， 比 如 类 似 Scala 中 的 Option 类 : 这 种 类 型 可 以 防止 null 的 使 用 ， 当 
对 象 包 含 一 个 值 时 返回 Some 类 ， 当 对 象 为 空 时 则 返回 None 


sealed class Option<out T> { 
class Some<out T> : Option<T>() 
object None : Option<Nothing>( ) 


有 一 件 关 于 密封 类 很 不 错 的 事情 是 当 我 们 使 用 when 表达 式 时 ， 我 们 可 以 匹配 所 有 
选项 而 不 使 用 else PX: 


val result = when (option) { 
is Option.Some<*> -> "Contains a value" 
is Option.None -> "Empty" 


$+ (Exceptions) 


在 Kotlin 中 ， 所 有 的 Exception 都 是 实现 了 Throwable ， 含 有 一 个 message HL 
未 经 检查 。 这 表示 我 们 不 会 强迫 我 们 在 任何 地 方 使 用 try/catch 。 这 与 Java 中 不 
太一 样 ， 比 如 在 抛 出 IOException 的 方法 ， 我 们 需要 使 用 try-catch 包围 代码 
块 。 通 过 ee 像 Bruce Eckel ` Rod 
Waldhoff 或 Anders Hejlsberg 等 人 可 以 给 你 关于 这 个 更 好 的 观点 。 


抛 出 异常 的 方式 与 Java 很 类 似 : 


throw MyException("Exception message") 


try 表达 式 也 是 相同 的 : 


try{ 
// 一 些 代 码 


} 

catch (e: SomeException) { 
// RE 

} 

finally { 
// 可 选 的 finally 块 


E 


E koii > throw 和 try 都 是 表达 式 ， 这 意味 着 它们 可 以 被 赋值 给 一 个 变量 。 
这 个 在 处 理 一 些 边 界 问题 的 时 候 确实 非常 有 用 : 


val s = when(x){ 
is Int -> “Int instance” 
is String -> "String instance" 
else -> throw UnsupportedOperationException("Not valid type" 


val s = try { x as String } catch(e: ClassCastException) { null 
} 


结尾 


感谢 你 阅读 本 书 。 通 过 本 书 ， 我 们 通过 来 实现 一 个 Android App 的 例子 来 学 习 
Kotlin 。 这 个 天 气 预 报 的 App 是 一 个 不 错 的 例子 ， 它 实现 了 大 部 分 App 需 要 的 一 些 基 
本 特性 : 一 个 主 / 从 Ul， 通过 API 通 信 ， 数 据 库存 储 ，shared preferences...... 


用 这 个 方式 不 错 的 地 方 是 你 使 用 它们 的 使 用 学 习 到 了 大 部 分 的 Kotlin 中 重要 的 概 

念 。 我 觉得 新 的 语言 在 丨 正 实践 的 时 候 更 加 容 匈 被 掌握 。 这 是 我 主要 的 目标 ， 参 考 
书 的 确 是 一 个 解决 一 些 标准 问题 的 很 好 的 工具 ， 但 是 我 们 从 头 到 尾 阅 读 起 来 是 很 困 
难 的 。 而 且 作 为 一 些 例子 也 是 脱离 于 一 个 大 的 上 下 文 环 境 ， 很 难 理解 这 些 特 性 可 以 
解决 哪 类 问题 。 


而 且 实际 上 本 书 的 其 它 的 目标 : 展示 给 你 看 在 Android 中 你 会 遇 到 的 实际 问题 ， 并 
且 使 用 Kotlin 怎 么 去 解决 它们 。 一 些 Android 开 发 者 在 处 理 异步 、 数 据 库 或 者 处 理 
Activity 中 非常 元 长 的 listener 时 发 现 了 很 多 的 问题 。 通 过 作为 一 个 例子 的 丫 正 的 
App， 我 们 遇 到 了 很 多 问题 并 且 学 习 到 了 新 的 语言 和 库 的 特性 。 


我 希望 这 些 目 标 已 经 达到 了 ， 并 且 我 巾 的 希望 你 不 仅仅 是 在 学 习 Kotlin， 而且 是 在 
本 书 的 阅读 中 得 到 享受 。 我 被 说 服 了 ，Kotlin 对 于 Android 开 发 者 而 言 是 目前 最 好 的 
Java 的 替代 者 ， 我 们 会 在 接 下 来 的 时 间 中 看 到 它 的 进步 。 当 它 事情 发 生 时 你 将 会 是 
第 一 个 上 船 的 人 ， 而 且 在 你 的 圈子 中 你 将 会 处 于 一 个 完美 的 参考 人 的 位 置 。 


本 书 已 经 结束 了 ， 但 是 这 不 是 意味 着 它 就 死亡 了 。 我 将 会 一 直 根 据 最 新 版 本 保持 更 
新 (至 少 到 1.0) ， 根 据 你 的 留言 和 建议 来 检查 并 优化 它 。 有 什么 想法 可 以 在 任何 时 
候 联 系 我 ， 告 诉 我 你 的 想法 、 你 发 现 的 错误 、 不 够 清晰 的 概念 或 者 任何 你 顾虑 的 东 
西 o 


这 几 个 月 再 写 这 本 书 的 过 程 中 经 历 了 一 个 不 可 思议 的 旅行 。 我 也 学 习 到 了 很 多 ， 所 
以 感谢 你 们 的 帮助 让 Kotlin for Android Developers 这 本 书 成 为 现实 。 

给 你 最 好 的 祝福 ， 

Antonio Leiva 


e 网 站 : antonioleiva 
e 邮箱 : contact@antonioleiva.com 
e Twitter : @lime_cl 
e Google+ : +AntonioLeivaGordillo 
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